Skip to content

Update nf-winuser-setwindowshookexa.md #1856

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jwmsft merged 2 commits into from
Nov 15, 2024
Merged

Update nf-winuser-setwindowshookexa.md #1856

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8e891d7
Update nf-winuser-setwindowshookexa.md
anderjef Jul 11, 2024
9fb507c
Merge branch 'docs' into patch-1
jwmsft Nov 15, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 14 additions & 11 deletions sdk-api-src/content/winuser/nf-winuser-setwindowshookexa.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,8 @@ Installs a hook procedure that monitors messages before the system sends them to
</dl>
</td>
<td width="60%">
Installs a hook procedure that monitors messages after they have been processed by the destination window procedure. For more information, see the <a href="/windows/win32/api/winuser/nc-winuser-hookproc">HOOKPROC callback function</a> hook procedure.

Installs a hook procedure that monitors messages after they have been processed by the destination window procedure. For more information, see the [HOOKPROC callback function](nc-winuser-hookproc.md) hook procedure.

</td>
</tr>
Expand All @@ -105,7 +106,8 @@ Installs a hook procedure that monitors messages after they have been processed
</dl>
</td>
<td width="60%">
Installs a hook procedure that receives notifications useful to a CBT application. For more information, see the <a href="/windows/win32/winmsg/cbtproc">CBTProc</a> hook procedure.

Installs a hook procedure that receives notifications useful to a CBT application. For more information, see the [CBTProc](/windows/win32/winmsg/cbtproc) hook procedure.

</td>
</tr>
Expand Down Expand Up @@ -156,7 +158,7 @@ Installs a hook procedure that monitors messages posted to a message queue. For
> [!WARNING]
> **Windows 11 and newer**: Journaling hook APIs are not supported. We recommend using the [**SendInput**](/windows/win32/api/winuser/nf-winuser-sendinput) TextInput API instead.

Installs a hook procedure that posts messages previously recorded by a <a href="/windows/desktop/winmsg/about-hooks">WH_JOURNALRECORD</a> hook procedure. For more information, see the [JournalPlaybackProc](/windows/win32/winmsg/journalplaybackproc) hook procedure.
Installs a hook procedure that posts messages previously recorded by a [WH_JOURNALRECORD](/windows/desktop/winmsg/about-hooks) hook procedure. For more information, see the [JournalPlaybackProc](/windows/win32/winmsg/journalplaybackproc) hook procedure.

</td>
</tr>
Expand All @@ -183,7 +185,7 @@ Installs a hook procedure that records input messages posted to the system messa
</td>
<td width="60%">

Installs a hook procedure that monitors keystroke messages. For more information, see the <a href="/windows/win32/winmsg/keyboardproc">KeyboardProc</a> hook procedure.
Installs a hook procedure that monitors keystroke messages. For more information, see the [KeyboardProc](/windows/win32/winmsg/keyboardproc) hook procedure.

</td>
</tr>
Expand All @@ -207,7 +209,7 @@ Installs a hook procedure that monitors low-level keyboard input events. For mor
</td>
<td width="60%">

Installs a hook procedure that monitors mouse messages. For more information, see the <a href="/windows/win32/winmsg/mouseproc">MouseProc</a> hook procedure.
Installs a hook procedure that monitors mouse messages. For more information, see the [MouseProc](/windows/win32/winmsg/mouseproc) hook procedure.

</td>
</tr>
Expand All @@ -219,7 +221,7 @@ Installs a hook procedure that monitors mouse messages. For more information, se
</td>
<td width="60%">

Installs a hook procedure that monitors low-level mouse input events. For more information, see the <a href="/windows/win32/winmsg/lowlevelmouseproc">LowLevelMouseProc</a> hook procedure.
Installs a hook procedure that monitors low-level mouse input events. For more information, see the [LowLevelMouseProc](/windows/win32/winmsg/lowlevelmouseproc) hook procedure.

</td>
</tr>
Expand All @@ -231,7 +233,7 @@ Installs a hook procedure that monitors low-level mouse input events. For more i
</td>
<td width="60%">

Installs a hook procedure that monitors messages generated as a result of an input event in a dialog box, message box, menu, or scroll bar. For more information, see the <a href="/windows/win32/winmsg/messageproc">MessageProc</a> hook procedure.
Installs a hook procedure that monitors messages generated as a result of an input event in a dialog box, message box, menu, or scroll bar. For more information, see the [MessageProc](/windows/win32/winmsg/messageproc) hook procedure.

</td>
</tr>
Expand All @@ -242,7 +244,8 @@ Installs a hook procedure that monitors messages generated as a result of an inp
</dl>
</td>
<td width="60%">
Installs a hook procedure that receives notifications useful to shell applications. For more information, see the <a href="/windows/win32/winmsg/shellproc">ShellProc</a> hook procedure.

Installs a hook procedure that receives notifications useful to shell applications. For more information, see the [ShellProc](/windows/win32/winmsg/shellproc) hook procedure.

</td>
</tr>
Expand All @@ -254,7 +257,7 @@ Installs a hook procedure that receives notifications useful to shell applicatio
</td>
<td width="60%">

Installs a hook procedure that monitors messages generated as a result of an input event in a dialog box, message box, menu, or scroll bar. The hook procedure monitors these messages for all applications in the same desktop as the calling thread. For more information, see the <a href="/windows/win32/winmsg/sysmsgproc">SysMsgProc</a> hook procedure.
Installs a hook procedure that monitors messages generated as a result of an input event in a dialog box, message box, menu, or scroll bar. The hook procedure monitors these messages for all applications in the same desktop as the calling thread. For more information, see the [SysMsgProc](/windows/win32/winmsg/sysmsgproc) hook procedure.

</td>
</tr>
Expand Down Expand Up @@ -284,7 +287,7 @@ Type: <b>HHOOK</b>

If the function succeeds, the return value is the handle to the hook procedure.

If the function fails, the return value is <b>NULL</b>. To get extended error information, call <a href="/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a>.
If the function fails, the return value is <b>NULL</b>. To get extended error information, call [GetLastError](/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror).

## -remarks

Expand Down Expand Up @@ -400,7 +403,7 @@ This behavior is similar to what happens when there is an architecture mismatch

#### Examples

For an example, see <a href="/windows/desktop/winmsg/using-hooks">Installing and Releasing Hook Procedures</a>.
For an example, see [Installing and Releasing Hook Procedures](/windows/desktop/winmsg/using-hooks).

> [!NOTE]
> The winuser.h header defines SetWindowsHookEx as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see [Conventions for Function Prototypes](/windows/win32/intl/conventions-for-function-prototypes).
Expand Down