获取表示新注册事件的 ISyncRegistrationChange 对象。
语法
HRESULT GetChange(
[in] HANDLE hEvent,
[out] ISyncRegistrationChange **ppChange
);
参数
[in] hEvent
RegisterForEvent 方法返回的 HANDLE。
[out] ppChange
包含事件的 ISyncRegistrationChange 对象,以及已更改的同步提供程序或同步提供程序配置 UI 的 ID。
返回值
可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
已检索所有未完成的事件。 |
|
无效指针。 |
注解
此方法重置传入的事件,以便在注册存储中的后续更改时设置该事件。 为了从存储中检索所有事件,应调用此方法,直到返回 S_FALSE 并且 ppChange 为 NULL。
此方法返回自 RegisterForEvent 或 GetChange (上次为给定 HANDLE 调用) 发生的更改。 这意味着,如果在调用 GetChange 之前对某个项进行了多次更改,这些更改将表示为从 GetChange 返回的单个更改对象。 在两次调用之间注册和注销项目的情况下,不会返回任何更改。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | syncregistration.h |