ISyncProviderRegistration::GetChange 方法 (syncregistration.h)

获取表示新注册事件的 ISyncRegistrationChange 对象。

语法

HRESULT GetChange(
  [in]  HANDLE                  hEvent,
  [out] ISyncRegistrationChange **ppChange
);

参数

[in] hEvent

RegisterForEvent 方法返回的 HANDLE

[out] ppChange

包含事件的 ISyncRegistrationChange 对象,以及已更改的同步提供程序或同步提供程序配置 UI 的 ID。

返回值

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

返回代码 说明
S_OK
方法成功。
S_FALSE
已检索所有未完成的事件。
E_POINTER
无效指针。

注解

此方法重置传入的事件,以便在注册存储中的后续更改时设置该事件。 为了从存储中检索所有事件,应调用此方法,直到返回 S_FALSE 并且 ppChangeNULL

此方法返回自 RegisterForEventGetChange (上次为给定 HANDLE 调用) 发生的更改。 这意味着,如果在调用 GetChange 之前对某个项进行了多次更改,这些更改将表示为从 GetChange 返回的单个更改对象。 在两次调用之间注册和注销项目的情况下,不会返回任何更改。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 syncregistration.h

另请参阅

ISyncProviderRegistration 接口