COM 中的事件处理

在 COM 事件处理中，您使用 event_source 和 event_receiver 特性分别设置事件源和事件接收器，并指定 type=com。 这些特性为自定义接口、调度接口和双重接口注入相应的代码，从而使这些接口能够应用到的类激发事件并通过 COM 连接点处理事件。

声明事件

在事件源类中，在接口声明上使用 __event 关键字以将该接口的方法声明为事件。 当您将该接口的事件作为接口方法调用时，将激发这些事件。 事件接口上的方法可以有零个或多个参数（应全是 in 参数）。 返回类型可以是 void 或任何整型。

定义事件处理程序

在事件接收器类中，可定义事件处理程序，这些处理程序是具有与它们将处理的事件匹配的签名（返回类型、调用约定和参数）的方法。 对于 COM 事件，调用约定不必匹配；有关详细信息，请参阅下文中的依赖于布局的 COM 事件。

将事件处理程序挂钩到事件

同样在事件接收器类中，可使用内部函数 __hook 将事件与事件处理程序关联，并可使用 __unhook 取消事件与事件处理程序的关联。 您可将多个事件挂钩到一个事件处理程序，或将多个事件处理程序挂钩到一个事件。

备注

通常，有两种方法使 COM 事件接收器能够访问事件源接口定义。第一种是共享公共头文件，如下所示。第二种是将 #import 与 embedded_idl 导入限定符结合使用，以便让事件源类型库写入到保留了特性生成的代码的 .tlh 文件。

激发事件

若要激发事件，只需调用在事件源类中使用 __event 关键字声明的接口中的方法。 如果处理程序已挂钩到事件，则将调用处理程序。

COM 事件代码

下面的示例演示如何在 COM 类中激发事件。 若要编译并运行此示例，请参考代码中的注释。

// evh_server.h
#pragma once

[ dual, uuid("00000000-0000-0000-0000-000000000001") ]
__interface IEvents {
   [id(1)] HRESULT MyEvent([in] int value);
};

[ dual, uuid("00000000-0000-0000-0000-000000000002") ]
__interface IEventSource {
   [id(1)] HRESULT FireEvent();
};

class DECLSPEC_UUID("530DF3AD-6936-3214-A83B-27B63C7997C4") CSource;

接着是服务器：

// evh_server.cpp
// compile with: /LD
// post-build command: Regsvr32.exe /s evh_server.dll
#define _ATL_ATTRIBUTES 1
#include <atlbase.h>
#include <atlcom.h>
#include "evh_server.h"

[ module(dll, name="EventSource", uuid="6E46B59E-89C3-4c15-A6D8-B8A1CEC98830") ];

[coclass, event_source(com), uuid("530DF3AD-6936-3214-A83B-27B63C7997C4")]
class CSource : public IEventSource {
public:
   __event __interface IEvents; 

   HRESULT FireEvent() {
      __raise MyEvent(123);
      return S_OK;
   }
};

再然后是客户端：

// evh_client.cpp
// compile with: /link /OPT:NOREF
#define _ATL_ATTRIBUTES 1
#include <atlbase.h>
#include <atlcom.h>
#include <stdio.h>
#include "evh_server.h"

[ module(name="EventReceiver") ];

[ event_receiver(com) ]
class CReceiver {
public:
   HRESULT MyHandler1(int nValue) {
      printf_s("MyHandler1 was called with value %d.\n", nValue);
      return S_OK;
   }

   HRESULT MyHandler2(int nValue) {
      printf_s("MyHandler2 was called with value %d.\n", nValue);
      return S_OK;
   }

   void HookEvent(IEventSource* pSource) {
      __hook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler1);
      __hook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler2);
   }

   void UnhookEvent(IEventSource* pSource) {
      __unhook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler1);
      __unhook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler2);
   }
};

int main() {
   // Create COM object
   CoInitialize(NULL);
   {
      IEventSource* pSource = 0;
      HRESULT hr = CoCreateInstance(__uuidof(CSource), NULL,         CLSCTX_ALL, __uuidof(IEventSource), (void **) &pSource);
      if (FAILED(hr)) {
         return -1;
      }

      // Create receiver and fire event
      CReceiver receiver;
      receiver.HookEvent(pSource);
      pSource->FireEvent();
      receiver.UnhookEvent(pSource);
   }
   CoUninitialize();
   return 0;
}

输出

MyHandler1 was called with value 123.
MyHandler2 was called with value 123.

依赖于布局的 COM 事件

布局依赖性只是 COM 编程中的一个问题。 在本机和托管事件处理中，处理程序的签名（返回类型、调用约定和参数）必须与其事件匹配，但处理程序的名称不必与其事件匹配。

但是，在 COM 事件处理中，如果将 event_receiver 的 layout_dependent 参数设置为 true，则将强制名称和签名匹配。 这意味着事件接收器中处理程序的名称和签名必须与处理程序将挂钩到的事件的名称和签名完全匹配。

当 layout_dependent 设置为 false 时，激发事件方法与挂钩方法（其委托）之间的调用约定和存储类（虚拟、静态等）可以混合和匹配。 将 layout_dependent 设置为 true 效率会稍微高一点。

例如，假设 IEventSource 定义为具有下列方法：

[id(1)] HRESULT MyEvent1([in] int value);
[id(2)] HRESULT MyEvent2([in] int value);

假定事件源具有以下形式：

[coclass, event_source(com)]
class CSource : public IEventSource {
public:
   __event __interface IEvents;

   HRESULT FireEvent() {
      MyEvent1(123);
      MyEvent2(123);
      return S_OK;
   }
};

则在事件接收器中，挂钩到 IEventSource 中的方法的任何处理程序必须与其名称和签名匹配，如下所示：

[coclass, event_receiver(com, true)]
class CReceiver {
public:
   HRESULT MyEvent1(int nValue) {  // name and signature matches MyEvent1
      ...
   }
   HRESULT MyEvent2(E c, char* pc) {  // signature doesn't match MyEvent2
      ...
   }
   HRESULT MyHandler1(int nValue) {  // name doesn't match MyEvent1 (or 2)
      ...
   }
   void HookEvent(IEventSource* pSource) {
      __hook(IFace, pSource);  // Hooks up all name-matched events 
                               // under layout_dependent = true
      __hook(&IFace::MyEvent1, pSource, &CReceive::MyEvent1);   // valid
      __hook(&IFace::MyEvent2, pSource, &CSink::MyEvent2);   // not valid
      __hook(&IFace::MyEvent1, pSource, &CSink:: MyHandler1); // not valid
   }
};

请参见

参考

事件处理