c语言hook作用,C++事件处理中的__hook与__unhook用法详解

__hook__hook将处理程序方法与事件关联。

语法

long __hook(

&SourceClass::EventMethod,

source,

&ReceiverClass::HandlerMethod

[, receiver = this]

);

long __hook(

interface,

source

);

参数

&SourceClass::EventMethod

指向要将事件处理程序方法挂钩到的事件方法的指针：

本机 C++ 事件：SourceClass 是事件源类，EventMethod 是事件。

COM 事件：SourceClass 是事件源接口，EventMethod 是其方法之一。

托管事件：SourceClass 是事件源类，EventMethod 是事件。

interface

要挂钩到 receiver 的接口名称，仅适用于 COM 事件接收器，其中 event_receiver 特性的 layout_dependent 参数为 true。

source

指向事件源的实例的指针。根据 event_receiver 中指定的代码 type，source 可为下列项之一：

本机事件源对象指针。

基于 IUnknown 的指针(COM 源)。

托管对象指针(针对托管事件)。

&ReceiverClass::HandlerMethod

指向要挂钩到事件的事件处理程序方法的指针。处理程序将指定为类的方法或对同一方法的引用；如果不指定类名称，则 __hook 假定该类是从中调用它的类。

本机 C++ 事件：ReceiverClass 是事件接收器类，HandlerMethod 是处理程序。

COM 事件：ReceiverClass 是事件接收器接口，HandlerMethod 是其处理程序之一。

托管事件：ReceiverClass 是事件接收器类，HandlerMethod 是处理程序。

receiver(可选)

指向事件接收器类的实例的指针。如果不指定接收器，则默认为在其中调用 __hook 的接收器类或结构。

用法

可以在事件接收器类的外部的任何函数范围(包括 main)中使用。

备注

请使用事件接收器中的内部函数 __hook 将处理程序方法与事件方法关联或挂钩。随后会在源引发指定事件时调用指定的事件处理程序。可以将多个处理程序挂钩到单个事件，或将多个事件挂钩到单个处理程序。

__hook 有两种形式。大多数情况下，可以使用第一种(四个形参)形式，具体而言，就是针对其中的 event_receiver 特性的 layout_dependent 参数是 false 的 COM 事件接收器。

在这些情况下，当在其中一个方法上激发事件前，不需要在接口中挂钩所有方法；只需挂钩处理事件的方法。可以只对 layout_dependent=true 的 COM 事件接收器使用第二种(二个形参)形式的 __hook。

__hook 将返回一个长值。非零返回值表示发生了错误(托管事件引发了异常)。

编译器将检查是否存在事件以及事件签名是否与委托签名一致。

除 COM 事件外，可以在事件接收器的外部调用 __hook 和 __unhook。

使用 __hook 的替代方法是使用 += 运算符。

注意

模板类或结构不能包含事件。

__unhook取消处理程序方法与事件的关联。

语法

long __unhook(

&SourceClass::EventMethod,

source,

&ReceiverClass::HandlerMethod

[, receiver = this]

);

long __unhook(

interface,

source

);

long __unhook(

source

);

参数

&SourceClass::EventMethod

指向从中解除挂钩事件处理程序方法的事件方法的指针：

本机 C++ 事件：SourceClass 是事件源类，EventMethod 是事件。

COM 事件：SourceClass 是事件源接口，EventMethod 是其方法之一。

托管事件：SourceClass 是事件源类，EventMethod 是事件。

interface

将从 receiver 中解除挂钩的接口名称，仅适用于 COM 事件接收器，其中 event_receiver 特性的 layout_dependent 参数为 true。

source

指向事件源的实例的指针。根据 event_receiver 中指定的代码 type，source 可为下列项之一：

本机事件源对象指针。

基于 IUnknown 的指针(COM 源)。

托管对象指针(针对托管事件)。

&ReceiverClass::HandlerMethod

指向要从事件中解除挂钩的事件处理程序方法的指针。处理程序将指定为类的方法或对同一方法的引用；如果不指定类名称，则 __unhook 假定该类是从中调用它的类。

本机 C++ 事件：ReceiverClass 是事件接收器类，HandlerMethod 是处理程序。

COM 事件：ReceiverClass 是事件接收器接口，HandlerMethod 是其处理程序之一。

托管事件：ReceiverClass 是事件接收器类，HandlerMethod 是处理程序。

receiver(可选)

指向事件接收器类的实例的指针。如果不指定接收器，则默认为在其中调用 __unhook 的接收器类或结构。

用法

可以在事件接收器类的外部的任何函数范围(包括 main)中使用。

备注

使用事件接收器中的内部函数 __unhook 取消处理程序方法与事件方法的关联或从事件方法“解除挂钩”处理程序方法。

__unhook 有三种形式。在大多数情况下，可以使用第一种 (four-argument) 形式。只能为 COM 事件接收器使用 __unhook 的第二种 (two-argument) 形式；这将解除挂钩整个事件接口。可以使用第三种 (one-argument) 形式从指定的源中解除挂钩所有委托。

非零返回值指示已发生错误(托管事件将引发异常)。

如果对尚未挂钩的事件和事件处理程序调用 __unhook，它将不起作用。

在编译时，编译器将验证事件是否存在，并利用指定的处理程序执行参数类型检查。

除 COM 事件外，可以在事件接收器的外部调用 __hook 和 __unhook。

作为使用 __unhook 的替代方式，可以使用 -= 运算符。

有关新语法中编码托管事件的信息，请参阅event(C++ 组件扩展)。

注意

模板类或结构不能包含事件。