各种钩子函数详解

钩子类型

每一种类型的hook可以使应用程序能够监视不同类型的系统消息处理机制。下面描述所有可以利用的hook类型。

1、wh_callwndproc和wh_callwndprocret hooks

wh_callwndproc和wh_callwndprocrethooks使你可以监视发送到窗口过程的消息。系统在消息发送到接收窗口过程之前调用wh_callwndprochook子程，并且在窗口过程处理完消息之后调用wh_callwndprocret hook子程。

wh_callwndprocret hook传递指针到cwpretstruct结构，再传递到hook子程。

cwpretstruct结构包含了来自处理消息的窗口过程的返回值，同样也包括了与这个消息关联的消息参数。

2、wh_cbt hook

在以下事件之前，系统都会调用wh_cbt hook子程，这些事件包括：

1. 激活，建立，销毁，最小化，最大化，移动，改变尺寸等窗口事件；

2. 完成系统指令；

3. 来自系统消息队列中的移动鼠标，键盘事件；

4. 设置输入焦点事件；

5. 同步系统消息队列事件。

hook子程的返回值确定系统是否允许或者防止这些操作中的一个。

3、wh_debug hook

在系统调用系统中与其他hook关联的hook子程之前，系统会调用wh_debughook子程。你可以使用这个hook来决定是否允许系统调用与其他hook关联的hook子程。

4、wh_foregroundidle hook

当应用程序的前台线程处于空闲状态时，可以使用wh_foregroundidlehook执行低优先级的任务。当应用程序的前台线程大概要变成空闲状态时，系统就会调用wh_foregroundidlehook子程。

5、wh_getmessage hook

应用程序使用wh_getmessage hook来监视从getmessage orpeekmessage函数返回的消息。你可以使用wh_getmessagehook去监视鼠标和键盘输入，以及其他发送到消息队列中的消息。

6、wh_journalplayback hook

wh_journalplaybackhook使应用程序可以插入消息到系统消息队列。可以使用这个hook回放通过使用wh_journalrecordhook记录下来的连续的鼠标和键盘事件。只要wh_journalplaybackhook已经安装，正常的鼠标和键盘事件就是无效的。

wh_journalplayback hook是全局hook，它不能象线程特定hook一样使用。

wh_journalplaybackhook返回超时值，这个值告诉系统在处理来自回放hook当前消息之前需要等待多长时间（毫秒）。这就使hook可以控制实时事件的回放。

wh_journalplayback是system-wide localhooks，它??不??射到任何行程位址空駣??

7、wh_journalrecord hook

wh_journalrecordhook用来监视和记录输入事件。典型的，可以使用这个hook记录连续的鼠标和键盘事件，然后通过使用wh_journalplaybackhook来回放。

wh_journalrecord hook是全局hook，它不能象线程特定hook一样使用。

wh_journalrecord是system-wide local hooks，它??不??射到任何行程位址空駣??

8、wh_keyboard hook

在应用程序中，wh_keyboard hook用来监视wm_keydown andwm_keyup消息，这些消息通过getmessage or peekmessagefunction返回。可以使用这个hook来监视输入到消息队列中的键盘消息。

9、wh_keyboard_ll hook

wh_keyboard_ll hook监视输入到线程消息队列中的键盘消息。

10、wh_mouse hook

wh_mouse hook监视从getmessage 或者 peekmessage函数返回的鼠标消息。使用这个hook监视输入到消息队列中的鼠标消息。

11、wh_mouse_ll hook

wh_mouse_ll hook监视输入到线程消息队列中的鼠标消息。

12、wh_msgfilter 和 wh_sysmsgfilter hooks

wh_msgfilter 和 wh_sysmsgfilterhooks使我们可以监视菜单，滚动条，消息框，对话框消息并且发现用户使用alt+tab or alt+esc组合键切换窗口。wh_msgfilterhook只能监视传递到菜单，滚动条，消息框的消息，以及传递到通过安装了hook子程的应用程序建立的对话框的消息。wh_sysmsgfilterhook监视所有应用程序消息。

wh_msgfilter 和 wh_sysmsgfilterhooks使我们可以在模式循环期间过滤消息，这等价于在主消息循环中过滤消息。

通过调用callmsgfilter function可以直接的调用wh_msgfilterhook。通过使用这个函数，应用程序能够在模式循环期间使用相同的代码去过滤消息，如同在主消息循环里一样。

13、wh_shell hook

外壳应用程序可以使用wh_shellhook去接收重要的通知。当外壳应用程序是激活的并且当顶层窗口建立或者销毁时，系统调用wh_shell hook子程。

wh_shell 共有５钟情?r：

1. 只要有个top-level、unowned 窗口被产生、起作用、或是被摧毁；

2. 当taskbar需要重画某个按钮；

3. 当系统需要显示关于taskbar的一个程序的最小化形式；

4. 当目前的键盘布局状态改变；

5. 当使用者按ctrl+esc去执行task manager（或相同级别的程序）。

按照惯例，外壳应用程序都不接收wh_shell消息。所以，在应用程序能够接收wh_shell消息之前，应用程序必须调用systemparametersinfofunction注册它自己。

函数原形:

[cpp] view plaincopyprint?

lresult callback shellproc( int ncode, wparam wparam,lparam lparam );  

函数功能:

挂钩处理过程是应用程序或库中定义的回调函数,它与函数 setwindowshookex搭配使用.此函数从系统接受外壳(shell)通知.类型hookproc定义了指向此类回调函数的指针.shellproc时应用程序或库中定义的相应回调的位置标志符.

参数:

ncode:

指示挂钩类型,该参数可以是以下值之一:

hshell_accessibilitystate: 对windows nt5.0或以上版本有效,指示"可访问性"已被改变.

hshell_activateshellwindow: shell应当激活其主窗口.

hshell_getminrect: windows 95 only: 一个窗口正在被最小化或者最大化,系统需要该窗口被最小化时的矩形坐标.

hshell_language : windows 95 only: 键盘语言被改变或者一个新的键盘布局被加载.

hshell_redraw: windows 95 only: 一个窗口在任务条上的标题已被重画.

hshell_taskman: windows 95 only: 用户已选择其任务列表.一个提供了任务的列表的shell应用程序当返回true,以阻止windows开始(执行)其任务列表.

hshell_windowactivated: windows 95 only: 激活状态已被转移给一个不同的顶层无属性主窗口.

hshell_windowcreated: 一个顶层无属性主窗口已被创建.当系统调用一个sheproc函数时,该窗口存在.

hshell_windowdestroyed:一个顶层无属性主窗口即将销毁.当系统调用sheproc 函数时.该窗口仍然存在.

若ncode的值小于0,则此挂钩处理过程必须将该消息不加处理地传送给函数callnexthookex 并返回其返回值.

wparam: 

此参数的值依赖于参数ncode,其依赖关系如下所示:

hshell_accessibilitystate: 指示哪一个可以访问特征已被改变了状态,可以是以下值之一:

access_filterkys,access_mousekeys,access_stickkeys.

hshell_getminrect:被最小化或者最大化的窗口句柄.hshell_language: 窗口的句柄.

hshell_redraw:被重画的窗口的句柄.hshell_windowactivated:被激活的窗口的句柄.

hshell_windowcreated:被创建的窗口的句柄.hshell_windowdestroyed:被销毁的窗口的句柄.

lparam:

hshell_getminrect:指向该rect结构的指针.hshell_language: 键盘布局的句柄.

hshell_redraw: 若该窗口正在闪现,则其值为true,否则为false.

hshell_windowactivated: 若该窗口是全屏模式,则其值为true,否则为false.返回值:返回值应为0.

备注:

此挂钩处理过程通过调用函数setwindowshookex ,指定wh_shll挂钩类型及其相应挂钩处理过程首地址来安装.

lresult callback sysmsgproc(int ncode,wparam wparam,lparam lparam);    

挂钩处理过程是应用程序或库中定义的回调函数,它与函数 setwindowshookex搭配使用.当一个对话框、消息框、菜单条、或滚动条中的输入事件发生，且由此引发的消息尚未被处理之前,系统对此挂钩处理过程进行调用.此函数可以对系统中所有的对话框、消息框、菜单条、或滚动条消息进行监视.

类型hookproc定义了指向此类回调函数的指针.sysmsgproc 是库中相应回调函数名的位置标志符.

指示产生此消息的输入事件类型.此参数可以是以下值之一:

msgf_dialogbox: 输入事件由一个消息框或者对话框产生.

msgf_menu: 输入事件由一个菜单条产生.

msgf_scrollbar: 输入事件由一个滚动条产生.

msgf_nextwindow: 输入事件由于用户摁下组合键<alt+tab>以激活另一个窗口而产生.

若ncode的值小于0,则此挂钩处理过程必须将该消息不加处理地传送给函数 callnexthookex 并返回其返回值.

wparam:

为null(0).

指向msg结构的[指针].

返回值:若ncode的值小于0,则此挂钩处理过程必须返回callnexthookex 的返回值.若ncode的值大于或等于0,并且此挂钩处理过程未对该消息进行处理,则调用函数callnexthookex 并返回其返回值是被推荐的.否则,其他安装了wh_sysmsgfilter挂钩的应用程序将无法收到此挂钩通知,并可能由此导致错误的行为.若此挂钩处理过程处理了此消息,它应返回一个非零值以避免系统再将此消息传送给目标窗口处理过程.

备注:一个应用程序通过调用函数setwindowshookex 指定 wh_sysmsgfilter挂钩类型及相应挂钩处理过程首地址来安装此挂钩.

函数原形：

bool callmsgfilter(lpmsg lpmsg, int ncode);   

该函数将特定消息和挂钩代码发送给与挂钩 wh_sysmsgfilter和wh_msgfilter 相联系的挂钩处理过程,一个 wh_sysmsgfilter 或者 wh_msgfilter挂钩处理过程是指应用程序定义的回调函数,这些回调函数负责检查,并可有选择地修改关于对话框、消息框、菜单条、滚动条的消息。

参数：

lpmsg：

指向一个msg结构,该结构包含发送给挂钩处理过程的消息.

指定挂钩处理过程需要使用的应用程序定义的代码,以确定如何对消息进行处理,该代码切忌采用与系统预定义的与wh_sysmsgfilter和wh_msgfilter挂钩相关的挂钩代码(msgf_ 和 hc_开头)相同的值.

返回值:

若该应用程序可对消息作进一步处理,则返回值为0,若该应用程序不能对该消息作进一步处理,则返回值为非0值.

备注:系统对callmsgfilter进行调用,以使得应用程序能够检查和控制在对对话框、消息框、菜单条、滚动条的内部处理过程中产生的,或是由用户按下<alt+tab>组合键以激活不同窗口时产生的消息流.

可通过调用函数setwindowshookex来安装此挂钩处理过程.

lresult callback callwndproc(int ncode,wparam wparam,lparam lparam );  

该函数挂钩处理过程是由应用程序定义或由库定义的回调函数,它与函数 setwindowshookex配套使用,系统调用此函数无论何时一旦函数 sendmessage被调用,在将消息发送至相应的窗口处理过程之前,系统先将该消息发送至挂钩处理过程,该挂钩处理过程可以对改消息进行检查,但不能修改之.

类型hookproc定义了指向此类回调函数的指针,callwndproc是应用程序定义或库定义的函数名的位置标志位.

指定该挂钩处理过程是否必须对该消息进行处理,若ncode 是hc_action,则该挂钩处理过程必须处理该消息.若ncode的值小于0,则此挂钩处理过程必须在未对该消息作进一步处理的情况下,将其发送给函数 callnexthookex并返回由 callnexthookex返回的值.

指示该消息是否由当前线程发出,若该消息由当前线程发出,其值为非0值,否则,其值为0.

指向一个cwpstruct结构,该结构包含了此消息的详细消息.

若ncode的值小于0,则此挂钩函数必须返回函数callnexthookex所返回的值;若ncode的值大于或等于0,我们极力推荐对函数callnexthookex进行调用,并返回其返回值.否则,其他安装了wm_callwndproc挂钩的应用程序将无法收到挂钩通知,从而导致错误的行为.若此挂钩没有调用函数callnexthookex,则返回值为0.

备注:挂钩处理函数callwndpro可以对消息进行检查,但不能修改之.在该挂钩处理过程将控制返回给系统之后,该消息被发送至相应的窗口过程.

一个应用程序通过调用setwindowshookex时指定wm_callwndproc挂钩类型及其相应挂钩处理过程的首地址来安装挂钩处理过程.

挂钩wm_callwndproc是在调用函数sendmessage的线程中被调用的,它并非在接受消息的线程中被调用.

lresult callback callwndretproc(int ncode,wparam wparam,lparam lparam);  

该函数挂钩处理过程是在应用程序或库中定义的回调函数,它与函数 setwindowshookex搭配使用,系统将在调用完 sendmessage之后调用之,该挂钩处理过程可以检查该消息,但不能修改之.

类型hookproc定义了一类指针指向此类回调函数,callwndretproc 仅仅是在应用程序或库中定义的相应函数名的位置标志符.

指定该挂钩处理过程是否必须对该消息进行处理,若ncode 是hc_action,则该挂钩处理过程必须处理该消息.若ncode的值小于0,则此挂钩处理过程必须不加处理的将其发送给函数callnexthookex并返回由 callnexthookex返回的值.

若ncode的值小于0,则此挂钩函数必须返回函数callnexthookex所返回的值;若ncode的值大于或等于0,我们极力推荐对函数callnexthookex进行调用,并返回其返回值.否则,其他安装了挂钩wm_callwndprocret的应用程序将无法收到挂钩通知,从而导致错误的行为.若此挂钩处理过程没有调用函数callnexthookex,则返回值为0.

备注: 一个应用程序通过调用setwindowshookex时指定wm_callwndprocret挂钩类型及其相应挂钩处理过程的首地址来安装挂钩处理过程.

lresult callback cbtproc(int ncode,wparam wparam,lparam lparam);  

该函数挂钩处理过程是在应用程序或库中定义的回调函数,它与函数 setwindowshookex配套使用,系统在缉获、创建、销毁、最小化、最大化、移动或改变一个窗口尺寸之前调用它;在结束一个系统命令之前调用它;在将一个鼠标或键盘事件从系统事件队列中删除之前调用它;在设置键盘焦点之前调用它,或在与系统消息队列进行同步之前调用它,一个基于计算机培训(cbt)的应用程序使用此挂钩处理过程来从系统接收有用的通知.

类型hookproc定义了指向此类回调函数的指针,cbtproc是应用程序定义或库定义的相应回调函数名的位置标识符.

指定一个代码,该代码被此挂钩处理过程用来决定如何处理此消息,该参数可以是下值中的一个:

hcbt_activate: 系统将要激活一个窗口.

hcbt_clickskipped: 系统已经从系统消息队列中删除了一个鼠标消息,依据收到的这一挂钩代码,一个cbt应用程序必须安装一个 wh_journalplayback 挂钩处理过程以响应此鼠标消息.

hcbt_createwnd:一个窗口将要被创建,系统在发送wm_create 或wm_nccreate消息至相应窗口之前调用该挂钩处理过程.若该挂钩处理过程返回一个非0值,则系统销毁该窗口,函数createwindow返回值为null(0),但消息wm_destroy不会被发送至相应窗口,若挂钩处理过程返回为零,窗口将被正常创建.

当hcbt_createwnd通知发出之时,相应窗口已被创建,但其最终尺寸及位置可能尚未确定,其父窗口也可能还尚未被创建,存在这样一种可能,消息被发送给新被创建的窗口,虽然该窗口尚未接收到wm_nccreate 或 wm_create 消息.也可能通过对cbt_createwnd结构的hwndinsertafter域的修改,来改变新被创建窗口在z序列中的位置.

hcbt_destroywnd:一个窗口将被销毁.

hcbt_keyskipped:系统已从系统消息队列中删除了一个键盘消息,依据收到的这个挂钩代码,一个cbt应用程序必须安装一个 wh_journalplayback挂钩处理过程以响应相应的键盘消息.

hcbt_minmax: 一个窗口将被最小化或最大化.

hcbt_movesize: 一个窗口将被移动或改变尺寸.

hcbt_qs: 系统已从系统消息队列中取到一个wm_queuesync 消息.

hcbt_setfocus: 一个窗口将要获得键盘焦点. 

hcbt_syscommand: 一个系统命令将被执行.这使得一个cbt应用程序可以避免因热键响应而进行任务切换.

若ncode的值小于0,此挂钩处理过程必须不加处理地将此消息发送给函数callnexthookex,并返回函数callnexthookex的返回值.

取决于参数ncode的值,详细信息参见以下的说明部分.

此挂钩处理过程的返回值决定了系统允许或禁止以下操作之一,对于与以下挂钩代码相应的操作,返回值为0则允许这样的操作,返回值为1则禁止.

hcbt_activate

hcbt_createwndhcbt_destroywnd

hcbt_minmax

hcbt_movesizehcbt_setfocus

hcbt_syscommand

对于与以下cbt挂钩代码相对应的操作,返回值被忽略.

hcbt_clickskipped

hcbt_keyskipped

hcbt_qs

除以下挂钩代码之外,不应当安装wh_journalplayback挂钩处理过程.

此挂钩处理过程必须放在某个动态链接库中,一个应用程序通过调用函数 setwindowshookex指定wh_cbt 挂钩类型与相应挂钩处理过程首地址来安装挂钩处理过程.

以下列示了参数wparam和lparam与每一种hcbt挂钩代码的关系.

指定一个长指针指向结构cbtactivatestruct 的长指针,该结构包含了指向激活窗口的句柄,并指示被激活者是否由于点击而发生改变.

 值                            参数wparam 　　 　　 参数lparam 

hcbt_activate 　　指定将要被激活的窗口句柄.

指定一个指向结构mousehookstruct的长指针,该结构包含点击测试代码及 鼠标消息发往的窗口句柄.hcbt_ clickskipped 值仅当一个wh_mouse挂钩被安装了之时才发送一个cbtproc挂钩处理过程,关于点击 测试代码的列表,参见 wm_nchittest.

hcbt_clickskipped　 标识鼠标消息从系统消息队列中被删除.

指定一个指向 cbt_createwnd结构的长指针,该结构包含窗口的初始化参数,这些参数包括窗口的坐标和尺寸,通过改变这些参数.一个cbtproc挂钩处理过程能够设置窗口的初始尺寸和位置.

hcbt_createwnd 指定新窗口的句柄.

hcbt_destroywnd 　指定将被销毁的窗口句柄. 　　 　未定义,必须设置为0.

指示重复次数,扫描码,键转义码,前驱键状态和上下文代码.仅当wh_keyboard挂钩被安装了之时,此hcbt_keyskipped值被发送 cbtproc 挂钩处理过程.欲获得更多信息,参见 wm_keyup 或wm_keydown

hcbt_keyskipped 指示虚拟键的代码.

低"字"部分指定一个显示窗口的值(sw_),以指定相应操作,详情参见showwindow,高"字"部分未定义.

hcbt_minmax 指定被最小化或最大化的窗口句柄  

指定一个指向rect结构的长指针,该结构包含窗口的坐标,通过改变结构的值,一个cbtproc的子处理过程能够设置窗口的最终位置.

hcbt_movesize 指定将被移动或改变尺寸的窗口句柄.

hcbt_qs 未定义,必须设置为0 未定义,必须设置为0

hcbt_setfocus 指定获得键盘焦点的窗口句柄. 指示失去键盘焦点的窗口句柄.

指示系统命令的值(sc_)以标识相应系统命令,欲知更多关于系统命令值的信息,参见wm_syscommand.

包含与wm_syscommand消息的lparam值相同的数据.若一个系统菜单命令被鼠标选种,则低"字"部分包含光标在屏幕坐标系中的x坐标值,高"字"部分包含y坐标值,其他情况下,此参数未被使用.

类型hookproc定义了一类指针指向此类回调函数,cbtproc 仅仅是在应用程序或库中定义的相应函数名的位置标识符.

lresult callback debugproc(int ncode,wparam wparam,lparam lparam);  

该挂钩处理过程是应用程序或库中定义的回调函数,它与函数setwindowshookex搭配使用,系统在调用与任何挂钩类型和相关的挂钩处理过程之前调用它,系统传送关于被调用的挂钩的信息给debugproc挂钩处理过程,此挂钩处理过程检查上述信息,并决定该挂钩是否被调用.

类型hookproc定义了指向此类回调函数的指针, debugproc是应用程序定义或库定义的相应回调函数名的位置标识符.

指示挂钩处理过程是否必须处理此消息.若ncode的值是hc_action,则挂钩处理过程必须处理此消息,若ncode之值小于0,此挂钩处理过程必须将此消息不加处理地传送给函数callnexthookex并返回其返回值.

指示将被调用的挂钩类型,此参数可以为以下值:

wh_callwndproc: 安装一个监视发送至目标窗口处理过程之的消息的挂钩处理过程,对该消息进行,详情参见callwndproc挂钩处理过程.

wh_callwndprocret :安装一个挂钩处理过程,以监视已刚被目标窗口处理过程处理过了的消息,详情参见 callwndretproc 挂钩处理过程.

wh_cbt :安装一个挂钩处理过程,接受对cbt应用程序有用的消息 ,详情参见 cbtproc 挂钩处理过程.

wh_debug:安装一个挂钩处理过程以便对其他挂钩处理过程进行调试, 详情参见debugproc挂钩处理过程.

wh_foregroundidle:安装一个挂钩处理过程,该挂钩处理过程当应用程序的前台线程即将进入空闲状态时被调用,它有助于在空闲时间内执行低优先级的任务.

wh_getmessage:安装一个挂钩处理过程对寄送至消息队列的消息进行监视,详情参见 getmsgproc 挂钩处理过程.

wh_journalplayback:安装一个挂钩处理过程,对此前由wh_journalrecord 挂钩处理过程纪录的消息进行寄送.详情参见 journalplaybackproc挂钩处理过程.

wh_journalrecord:安装一个挂钩处理过程,对寄送至系统消息队列的输入消息进行纪录.详情参见journalrecordproc挂钩处理过程.

wh_keyboard:安装一个挂钩处理过程对击键消息进行监视. 详情参见keyboardproc挂钩处理过程.

wh_mouse:安装一个挂钩处理过程,对鼠标消息进行监视. 详情参见 mouseproc挂钩处理过程.

wh_msgfilter:安装一个挂钩处理过程, 以监视由对话框、消息框、菜单条、或滚动条中的输入事件引发的消息.详情参见messageproc挂钩处理过程.

wh_shell:安装一个挂钩处理过程以接受对外壳应用程序有用的通知, 详情参见 shellproc挂钩处理过程.

wh_sysmsgfilter:安装一个挂钩处理过程,以监视由对话框、消息框、菜单条、或滚动条中的输入事件引发的消息.这个挂钩处理过程对系统中所有应用程序的这类消息都进行监视.详情参见 sysmsgproc挂钩处理过程.

指向一个debughookinfo结构,该结构包含希望被传送给相应挂钩处理过程的参数,为避免系统调用此挂钩,此挂钩处理过程必须返回一非0值,否则,此挂钩处理过程必须调用函数callnexthookex.

一个应用程序通过调用函数 setwindowshookex指定 wh_debug 挂钩类型与相应挂钩处理过程首地址来安装此挂钩处理过程.

dword foregroundidleproc(int code,dword wparam,long lparam);  

该函数处理过程是应用程序或库定义的回调函数, 它与函数setwindowshookex搭配使用,系统在前台线程进入空闲状态之前调用此函数.

类型hookproc定义了指向此类回调函数的指针, foregroundidleproc是应用程序定义或库定义的相应回调函数名的位置标识符.

code:

指示此挂钩处理过程是否必须处理消息, 若ncode的值是hc_action,则挂钩处理过程必须处理此消息,若ncode之值小于0,则此挂钩处理过程必须将此消息不加处理地传送给函数callnexthookex并返回其返回值.

未被使用.

若ncode的值小于0,则此挂钩函数必须返回函数callnexthookex所返回的值;若ncode的值大于或等于0,我们极力推荐对函数callnexthookex进行调用,并返回其返回值.否则,其他安装了挂钩wh_foregroundidle的应用程序将无法收到挂钩通知,从而导致错误的行为.若此挂钩处理过程没有调用函数callnexthookex,则返回值为0.

lresult callback getmsgproc(int code,wparam wparam,lparam lparam );  

该函数处理过程是应用程序或库定义的回调函数, 它与函数setwindowshookex搭配使用,每当函数getmessage从应用程序的消息队列中获得了一个消息时,系统就调用此函数,在将此获得的消息传送给相应窗口处理过程之前,系统将此消息传送给该挂钩处理过程.

类型hookproc定义了指向此类回调函数的指针, getmsgproc是应用程序定义或库定义的相应回调函数名的位置标识符.

指示此消息是否已从消息队列中被删除,此参数可以是以下值之一:

pm_noremove :指出该消息尚未从消息队列中被删除(一个应用程序调用函数peekmessage ,设置pm_noremove 标志).

pm_remove: 指出该消息已从消息队列中被删除. (一个应用程序调用函数 getmessage或peekmessage, 设置 pm_remove标志.)

指向结构msg,该结构包含了关于此消息的详细消息

若ncode的值小于0,则此挂钩函数必须返回函数callnexthookex所返回的值;若ncode的值大于或等于0,我们极力推荐对函数callnexthookex进行调用,并返回其返回值.否则,其他安装了挂钩wm_getmessage的应用程序将无法收到挂钩通知,从而导致错误的行为.若此挂钩处理过程没有调用函数callnexthookex,则返回值为0.

挂钩处理过程getmsgproc可以检查和修改此消息,在此挂钩处理过程将控制返回给系统之后,函数getmessage将此修改后的消息返回给最初调用他的应用程序,应用程序通过调用函数setwindowshookex指定wh_getmessage挂钩类型和相应挂钩处理过程的首地址来安装此挂钩处理过程.

lresult callback journalplaybackproc(int code, wparam wparam, lparam lparam);  

该函数处理过程是应用程序或库定义的回调函数, 它与函数setwindowshookex搭配使用.典型地,一个应用程序通过调用此函数来对先前有journalrecordproc挂钩处理过程纪录的一系列鼠标和键盘消息进行回放.一旦挂钩函数journalplaybackproc挂钩处理过程被安装,则通常的鼠标和键盘输入被禁止.

类型hookproc定义了指向此类回调函数的指针, journalplaybackproc是应用程序定义或库定义的相应回调函数名的位置标识符.

指示一个代码,被挂钩处理过程用来决定如何处理此消息,这个参数可以是以下值之一:

hc_getnext 挂钩处理过程必须将当前的鼠标或键盘消息拷贝至由参数lparam 所指结构eventmsg中. hc_noremove 一个正用wremovemsg为参数调用了 peekmessage的应用程序对pm_noremove标志进行设置,指示此消息在经过函数peekmessage的处理之后,并不从消息队列中被删除.

hc_skip此挂钩处理过程必须准备拷贝下一个鼠标或键盘消息至由参数lparam 所指定的结构eventmsg 中去,依据收到的代码hc_getnext ,此挂钩处理过程必须将消息拷贝至结构eventmsg 中去. hc_sysmodaloff 一个的有系统模式对话框已被销毁,此挂钩处理过程必须恢复对此消息的回调.

hc_sysmodalon 一个的有系统模式对话框正在被显示,直至此对话矿被销毁之前,此挂钩处理过程必须停止对消息的回调.

若ncode的值小于0,则此挂钩函数必须返回函数callnexthookex所返回的值.

指示一个null(0)值

指向一个eventmsg结构,该结构反映了正被此挂钩处理函数处理的消息,这个参数仅当参数ncode的值是hc_getnext时才有效.

为使系统在处理此消息之前先等待一段时间,返回值必须为一个以时钟计的时间量,该时间量指出了系统的等待时间长短.(此时间量可通过计算当前输入的消息与上一个输入消息的time成员的差别获得),若希望立即处理此消息,返回值应为0,此返回值仅当挂钩代码为hc_getnext时才被使用,否则,此返回值被忽略.

一个journalplaybackproc挂钩处理过程应当将输入消息拷贝给lparam参数,此消息必须是在先前使用journalrecordproc 挂钩处理过程时被纪录过的,在使用journalrecordproc挂钩处理过程时,不应对此消息进行修改,为了多次获得相同的消息,此挂钩处理过程可以多次以hc_getnext为参数被调用.

若ncode的值为hc_getnext而返回值大于0,则系统按返回值指定的毫秒值进入睡眠状态,当系统开始继续执行时,它会以hc_getnext为参数ncode的值再次调用次挂钩处理过程以获得相同的消息,此次调用journalplaybackproc的返回值为0,否则,系统又将回到睡眠状态,并以此次调用journalplaybackproc返回的毫秒数为睡眠时间,睡眠时间到后再重复上述操作.这就使得系统表现为被挂起.

与其余大多数全局挂钩处理过程不同,挂钩处理过程journalrecordproc和journalplaybackproc总是在设置了该挂钩的线程上下文中被调用.

在此挂钩处理过程将控制返回给系统后,此消息继续被处理.若ncode的值为hc_skip,则此挂钩处理过程必须准备在它下一次被调用时返回下一个纪录了的事件消息,安装journalplaybackproc挂钩处理过程通过调用函数setwindowshookex,指定wh_journalplayback挂钩类型及相应挂钩处理过程首地址来实现,如果用在日志回调过程中按下<ctrl+esc>或<ctrl+alt+del>组合键,系统将终止回调,取消此日志回调过程,并寄送一个wm_canceljournal消息给日志应用程序.

若此挂钩处理过程返回的消息在wm_keyfirst 或wm_keylast的范围内,则以下情形发生.

结构eventmsg的paraml成员指示按下的虚拟键编码值,结构eventmsg的paramh成员指示扫描吗,这种情况下无法指示出重复按键的次数,这个事件仅表示一个按键事件.

lresult callback journalrecordproc(int code,wparam wparam,lparam lparam);  

该函数处理过程是应用程序或库定义的回调函数, 它与函数setwindowshookex搭配使用,此函数纪录系统从系统消息队列中删除的消息,此后,一个应用程序可以通过使用挂钩处理过程journalplaybackproc对此消息进行回调.

类型hookproc定义了指向此类回调函数的指针, journalrecordproc是应用程序定义或库定义的相应回调函数名的位置标识符.

指示如何处理此消息,此参数可以是以下值之一:

hc_action: 参数lparam指向结构 eventmsg ,该结构包含从系统消息队列中删除了的消息的有关信息,此挂钩处理过程必须纪录下此结构的内容,将其拷贝到一个缓冲区或文件中.

hc_sysmodaloff: 一个系统的有模式对话框正在被销毁,此挂钩处理过程必须进行纪录.

hc_sysmodalon:一个系统的有模式对话框正在被显示,此挂钩处理过程必须停止纪录.

若ncode之值小于0,此挂钩处理过程必须将此消息不加处理地传送给函数callnexthookex并返回其返回值.

指定为null(0).

指向结构eventmsg ,该结构包含将被纪录的消息.

返回值被忽略.

备注:一个journalrecordproc挂钩处理过程必须拷贝但不能修改此消息,在次挂钩处理过程控制交还给系统之后,此消息继续被处理.

安装一个journalrecordproc挂钩处理过程是通过调用函数setwindowshookex指定wh_journalrecord挂钩类型和相应挂钩处理过程的首地址来安装此挂钩处理过程.过程并非只能存在于动态链接库中,一个应用程序自身也可拥有自己的journalrecordproc挂钩处理过程.

与其余大多数全局挂钩处理过程不同,挂钩处理过程journalrecordproc和journalplaybackproc总是在设置了该挂钩的线程上下文中被调用.一个安装了journalrecordproc挂钩处理过程的应用程序该对虚拟键vk_cancel进行监视(在大多数键盘上,虚拟键vk_cancel被实现为组合键< ctrl+break>),此虚拟键应被应用程序解释为用户希望终止进行日志纪录的信号,而应用程序对此进行响应,结束相应的纪录序列,并删除挂钩处理过程journalrecordproc,在这里,删除挂钩处理过程是很重要的,此举使得应用程序免于因为在一个挂钩处理过程内部被挂起而将系统锁住.

这种作为终止日志纪录信号的角色使得组合键<ctrl+break>本身无法被纪录,而组合键<ctrl+c>并不充当日志纪录信号的角色,所以可以被纪录,这里还有两种组合键是不能被纪录的:即<ctrl+esc> 和<ctrl+alt+del>,这两组组合键导致系统终止所有的日志活动(纪录或回调),删除所有的日志挂钩,并将消息wm_canceljournal寄送给日志应用程序.

lresult callback keyboardproc(int code,lparam lparam);  

该函数是应用程序或库文件定义的回调函数, 它与函数setwindowshookex搭配使用,当应用程序调用函数 getmessage 或peekmessage 并且当前恰好有一个键盘消息 (wm_keyup or wm_keydown) 将要被处理时,系统就调用此挂钩处理过程.

类型hookproc定义了指向此类回调函数的指针, keyboardproc是应用程序定义或库定义的相应回调函数名的位置标识符.

指定一个代码,该代码被挂钩处理过程用于决定如何处理此消息,此参数可以为以下值之一:

hc_action 参数 wparam 和 lparam包含一个击键消息的信息.

hc_noremove 参数wparam and lparam包含一个击键消息的信息,并且此击键消息尚未从消息队列中被删除(一个应用程序调用函数peekmessage 并设置了pm_noremove 标志).

若ncode的值小于0,则此挂钩函数必须不加处理地传送给函数callnexthookex,并返回其返回值.

指示产生此击键消息的虚拟键代码.

指示重复次数,扫描码,扩展标志,上下文代码,此前的键状态标志和变化状态标志,此参数可以是以下值的组合值:

0-15位:指示重复次数,此值纪录力偶由于用户继续摁键引发的击键重复次数.

16-23位:指示扫描码,此值依赖于键盘生产厂家.

第24位:指示此键是否为扩展键,比如功能键或数字小键盘上的键,当该键为扩展时,其值为1,否则为0.

25-28位:保留未用.

第29位:上下文代码.若alt键被摁下,则此值为1,否则为0.

第30位:指示此前的键状态,若在此消息被发送之前该键是摁下的,其值为1.若此前该键未被摁下,则其值为0.

第31位:指示变化状态,若此键正在被摁下,则其值位0. 正在被释放其值为1.

欲获得更多关于此lparam参数的信息,请参见 keystroke message flags.

若ncode的值小于0,则此挂钩函数必须返回函数callnexthookex所返回的值;若ncode的值大于或等于0,并且此挂钩处理过程并未对此消息进行处理,我们极力推荐对函数callnexthookex进行调用,并返回其返回值.否则,其他安装了挂钩wm_keyboard的应用程序将无法收到挂钩通知,从而导致错误的行为.若此挂钩处理过程对此消息进行了处理,它应返回非0值以避免系统将此消息传递给挂钩键上的其他处理过程或目标窗口的处理过程.

一个应用程序通过调用函数setwindowshookex指定wm_keyboard挂钩类型和相应挂钩处理过程的首地址来安装此挂钩处理过程.

lresult callback messageproc(int code,wparam wparam,lparam lparam);  

挂钩处理过程是应用程序或库中定义的回调函数,它与函数 setwindowshookex搭配使用.当一个对话框、消息框、菜单条、或滚动条中的输入事件发生，且由此引发的消息尚未被处理之前,系统对此挂钩处理过程进行调用.此函数可以对一个特定应用程序或所有应用程序的对话框、消息框、菜单条、或滚动引发的条消息进行监视.

类型hookproc定义了指向此类回调函数的指针. messageproc 是库中相应回调函数名的位置标志符.

msge_ddemgr:当动态数据交换管理库(dynamic data exchange management library (ddeml)正在等待一个同步处理的结束时产生此事件,关于ddeml的详情,参见dynamic data exchange management library .

若ncode的值小于0,则此挂钩处理过程必须返回callnexthookex 的返回值.若ncode的值大于或等于0,并且此挂钩处理过程未对该消息进行处理,则调用函数callnexthookex 并返回其返回值是被推荐的.否则,其他安装了wh_msgfilter挂钩的应用程序将无法收到此挂钩通知,并可能由此导致错误的行为.若此挂钩处理过程处理了此消息,它应返回一个非0值以避免系统再将此消息传送给挂钩链上的其他挂钩处理过程或目标窗口处理过程.

一个应用程序通过调用函数setwindowshookex指定wh_msgfilter挂钩类型和相应挂钩处理过程的首地址来安装此挂钩处理过程.

若一个应用程序使用了ddeml并实行同步处理,而且要求必须在消息被分派前处理之,则一定要使用wh_msgfilter挂钩.

lresult callback mouseproc(int ncode, wparam wparam, lparam lparam);  

该函数是应用程序或库文件定义的回调函数, 它与函数setwindowshookex搭配使用,当应用程序调用函数 getmessage 或peekmessage 并且当前恰好有一个鼠标消息将要被处理时,系统就调用此挂钩处理过程.

类型hookproc定义了指向此类回调函数的指针, mouseproc是应用程序定义或库定义的相应回调函数名的位置标识符.

指示一个代码被挂钩处理过程用于决定如何处理此消息,此参数可以是以下值之一:

hc_action 指示参数wparam 和lparam 包含了关于鼠标消息的信息.

hc_noremove 指示参数 wparam和lparam 中包含了关于鼠标的信息,而且此鼠标消息尚未从消息队列中被删除(一个应用程序调用函数peekmessage并设置了 pm_noremove标志).

指示鼠标消息的标识符,

指向mousehookstruct 结构的[指针].

若ncode的值小于0,则此挂钩函数必须返回函数callnexthookex所返回的值;若ncode的值大于或等于0,并且此挂钩处理过程尚未对此消息进行处理,我们极力推荐对函数callnexthookex进行调用,并返回其返回值.否则,其他安装了挂钩wm_mouse的应用程序将无法收到挂钩通知,从而导致错误的行为.若此挂钩处理过程对此消息进行了处理,它应返回非0值以避免系统将此消息传递给目标窗口的处理过程.

一个应用程序通过调用函数setwindowshookex指定wm_mouse挂钩类型和相应挂钩处理过程的首地址来安装此挂钩处理过程.此挂钩处理过程一定不能安装journalplaybackproc回调函数.