ISyncProviderRegistration::SetSyncProviderState 方法 (syncregistration.h)

设置指定同步提供程序的状态。

语法

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) 活动提供程序已更新,并且有要同步的新数据。
如果此参数设置为零,则将枚举所有同步提供程序状态。

返回值

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

返回代码 说明
S_OK
方法成功。
E_POINTER
无效指针。
SYNC_E_REGISTRATION_NOTREGISTERED
未注册具有指定实例 ID 的同步提供程序。

注解

若要获取同步提供程序状态,请调用 GetSyncProviderState 方法。

要求

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

另请参阅

ISyncProviderRegistration 接口