ISyncProviderRegistration：：RegisterForEvent 方法 (syncregistration.h)

注册用户以接收对注册存储进行更改时发生的新注册事件的到来通知。

语法

HRESULT RegisterForEvent(
  [out] HANDLE *phEvent
);

[out] phEvent

同步事件的 HANDLE ，用于通知调用方新注册事件的到来。

注意调用方不得关闭返回的 HANDLE。注册存储将管理 HANDLE 的内存，并在通过将 HANDLE 传递给 RevokeEvent 来撤销事件时或从内存中释放存储对象之前关闭它。

可能的返回代码包括但不限于下表中显示的值。

返回代码	说明
S_OK	方法成功。
E_POINTER	无效指针。

此方法返回的 HANDLE 由 GetChange 方法使用。从 RegisterForEvent 调用仅设置事件一次。仅当用户调用 GetChange 方法时，才会发生任何后续通知。

若要从此事件通知系统取消注册，请调用 RevokeEvent 方法。