SysMsgProc
The SysMsgProc
hook procedure is a library-defined callback function the system calls after an
input event occurs in a dialog box, message box, menu, or scroll bar, but
before the message generated by the input event is processed. The hook
procedure can monitor messages for any dialog box, message box, menu, or scroll
bar in the system.
LRESULT CALLBACK SysMsgProc(
|
int nCode, |
// message flag |
|
WPARAM wParam, |
// undefined |
|
LPARAM lParam |
// address of
structure with message data |
|
); |
|
Parameters
nCode
Specifies the
type of input event that generated the message. This parameter can be one of
the following values:
|
Value |
Meaning |
|
MSGF_DIALOGBOX |
The input
event occurred in a message box or dialog box. |
|
MSGF_MENU |
The input
event occurred in a menu. |
|
MSGF_SCROLLBAR |
The input
event occurred in a scroll bar. |
|
MSGF_NEXTWINDOW |
The input
event occurred as a result of the user s pressing the alt+tab key combination to activate a different window. |
If nCode
is less than zero, the hook procedure must pass the message to the CallNextHookEx function without further
processing and should return the value returned by CallNextHookEx.
wParam
Specifies a
NULL value.
lParam
Points to an MSG message structure.
Return Values
If the hook
procedure processes the message, the return value must be nonzero. Otherwise,
it must be zero.
Remarks
An
application installs the hook procedure by specifying the WH_SYSMSGFILTER hook
type and the address of the hook procedure in a call to the SetWindowsHookEx function.
SysMsgProc is a placeholder for the library-defined function
name.
See Also