C++事件處理中的hook與unhook用法詳解

更新時間：2016年01月26日 15:26:55 投稿：goldensun

這篇文章主要介紹了C++事件處理中__hook與__unhook的用法,C++中的COM類主要支持事件處理,需要的朋友可以參考下

__hook
__hook將處理程序方法與事件關聯(lián)。
語法

  long __hook(
 &SourceClass::EventMethod,
 source,
 &ReceiverClass::HandlerMethod
 [, receiver = this]
);
long __hook(
 interface,
 source
);

參數(shù)
&SourceClass::EventMethod
指向要將事件處理程序方法掛鉤到的事件方法的指針：
本機 C++ 事件：SourceClass 是事件源類，EventMethod 是事件。
COM 事件：SourceClass 是事件源接口，EventMethod 是其方法之一。
托管事件：SourceClass 是事件源類，EventMethod 是事件。
interface
要掛鉤到 receiver 的接口名稱，僅適用于 COM 事件接收器，其中 event_receiver 特性的 layout_dependent 參數(shù)為 true。
source
指向事件源的實例的指針。根據(jù) event_receiver 中指定的代碼 type，source 可為下列項之一：
本機事件源對象指針。
基于 IUnknown 的指針（COM 源）。
托管對象指針（針對托管事件）。
&ReceiverClass::HandlerMethod
指向要掛鉤到事件的事件處理程序方法的指針。處理程序將指定為類的方法或對同一方法的引用；如果不指定類名稱，則 __hook 假定該類是從中調(diào)用它的類。
本機 C++ 事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
COM 事件：ReceiverClass 是事件接收器接口，HandlerMethod 是其處理程序之一。
托管事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
receiver（可選）
指向事件接收器類的實例的指針。如果不指定接收器，則默認為在其中調(diào)用 __hook 的接收器類或結構。
用法
可以在事件接收器類的外部的任何函數(shù)范圍（包括 main）中使用。
備注
請使用事件接收器中的內(nèi)部函數(shù) __hook 將處理程序方法與事件方法關聯(lián)或掛鉤。隨后會在源引發(fā)指定事件時調(diào)用指定的事件處理程序?？梢詫⒍鄠€處理程序掛鉤到單個事件，或將多個事件掛鉤到單個處理程序。
__hook 有兩種形式。大多數(shù)情況下，可以使用第一種（四個形參）形式，具體而言，就是針對其中的 event_receiver 特性的 layout_dependent 參數(shù)是 false 的 COM 事件接收器。
在這些情況下，當在其中一個方法上激發(fā)事件前，不需要在接口中掛鉤所有方法；只需掛鉤處理事件的方法。可以只對 layout_dependent=true 的 COM 事件接收器使用第二種（二個形參）形式的 __hook。
__hook 將返回一個長值。非零返回值表示發(fā)生了錯誤（托管事件引發(fā)了異常）。
編譯器將檢查是否存在事件以及事件簽名是否與委托簽名一致。
除 COM 事件外，可以在事件接收器的外部調(diào)用 __hook 和 __unhook。
使用 __hook 的替代方法是使用 += 運算符。
注意
模板類或結構不能包含事件。

__unhook
取消處理程序方法與事件的關聯(lián)。
語法

   long __unhook(
  &SourceClass::EventMethod,
  source,
  &ReceiverClass::HandlerMethod
  [, receiver = this] 
);
long __unhook( 
  interface,
  source
);
long __unhook(
  source 
);

參數(shù)
&SourceClass::EventMethod
指向從中解除掛鉤事件處理程序方法的事件方法的指針：
本機 C++ 事件：SourceClass 是事件源類，EventMethod 是事件。
COM 事件：SourceClass 是事件源接口，EventMethod 是其方法之一。
托管事件：SourceClass 是事件源類，EventMethod 是事件。
interface
將從 receiver 中解除掛鉤的接口名稱，僅適用于 COM 事件接收器，其中 event_receiver 特性的 layout_dependent 參數(shù)為 true。
source
指向事件源的實例的指針。根據(jù) event_receiver 中指定的代碼 type，source 可為下列項之一：
本機事件源對象指針。
基于 IUnknown 的指針（COM 源）。
托管對象指針（針對托管事件）。
&ReceiverClass::HandlerMethod
指向要從事件中解除掛鉤的事件處理程序方法的指針。處理程序將指定為類的方法或對同一方法的引用；如果不指定類名稱，則 __unhook 假定該類是從中調(diào)用它的類。
本機 C++ 事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
COM 事件：ReceiverClass 是事件接收器接口，HandlerMethod 是其處理程序之一。
托管事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
receiver（可選）
指向事件接收器類的實例的指針。如果不指定接收器，則默認為在其中調(diào)用 __unhook 的接收器類或結構。
用法
可以在事件接收器類的外部的任何函數(shù)范圍（包括 main）中使用。
備注
使用事件接收器中的內(nèi)部函數(shù) __unhook 取消處理程序方法與事件方法的關聯(lián)或從事件方法“解除掛鉤”處理程序方法。
__unhook 有三種形式。在大多數(shù)情況下，可以使用第一種 (four-argument) 形式。只能為 COM 事件接收器使用 __unhook 的第二種 (two-argument) 形式；這將解除掛鉤整個事件接口?？梢允褂玫谌N (one-argument) 形式從指定的源中解除掛鉤所有委托。
非零返回值指示已發(fā)生錯誤（托管事件將引發(fā)異常）。
如果對尚未掛鉤的事件和事件處理程序調(diào)用 __unhook，它將不起作用。
在編譯時，編譯器將驗證事件是否存在，并利用指定的處理程序執(zhí)行參數(shù)類型檢查。
除 COM 事件外，可以在事件接收器的外部調(diào)用 __hook 和 __unhook。
作為使用 __unhook 的替代方式，可以使用 -= 運算符。
有關新語法中編碼托管事件的信息，請參閱event（C++ 組件擴展）。
注意
模板類或結構不能包含事件。