设置指定同步提供程序的状态。
语法
HRESULT SetSyncProviderState(
[in] LPCGUID pguidInstanceId,
[in] DWORD dwStateFlagsMask,
[in] DWORD dwStateFlags
);
参数
[in] pguidInstanceId
同步提供程序的唯一实例 ID。
[in] dwStateFlagsMask
同步提供程序状态标志,可用于屏蔽 (保留或删除现有状态) 。 如果此参数设置为零,则将枚举所有同步提供程序状态。 有关标志列表,请参阅 dwStateFlags 参数说明。
[in] dwStateFlags
以下表示同步提供程序状态的标志之一。
- SYNC_PROVIDER_STATE_ENABLED ( (DWORD) 0x00000001) 提供程序已启用并可用于同步。
- SYNC_PROVIDER_STATE_DIRTY ( (DWORD) 0x00000002) 活动提供程序已更新,并且有要同步的新数据。
返回值
可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
无效指针。 |
|
未注册具有指定实例 ID 的同步提供程序。 |
注解
若要获取同步提供程序状态,请调用 GetSyncProviderState 方法。
要求
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | syncregistration.h |