ISyncProviderRegistration::EnumerateSyncProviders 方法 (syncregistration.h)

返回一个 IEnumSyncProviderInfos 枚举接口,该接口枚举指定条件的所有已注册 的 ISyncProviderInfo 对象。

语法

HRESULT EnumerateSyncProviders(
  [in]  LPCGUID                pguidContentType,
  [in]  DWORD                  dwStateFlagsToFilterMask,
  [in]  DWORD                  dwStateFlagsToFilter,
  [in]  REFCLSID               refProviderClsId,
  [in]  DWORD                  dwSupportedArchitecture,
  [out] IEnumSyncProviderInfos **ppEnumSyncProviderInfos
);

参数

[in] pguidContentType

指定内容类型的 LPCGUID。 如果此参数为 NULL,则将枚举所有内容类型。

[in] dwStateFlagsToFilterMask

同步提供程序状态标志,可用于屏蔽 (保留或删除现有状态) 。 如果此参数设置为零,则将枚举所有同步提供程序状态。 有关标志列表,请参阅 dwStateFlagsToFilter 参数说明。

[in] dwStateFlagsToFilter

以下表示同步提供程序状态的标志之一。

  • SYNC_PROVIDER_STATE_ENABLED ( (DWORD) 0x00000001) 提供程序已启用并可用于同步。
  • SYNC_PROVIDER_STATE_DIRTY ( (DWORD) 0x00000002) 活动提供程序已更新,并且有要同步的新数据。
如果此参数设置为零,则将枚举所有同步提供程序状态。

[in] refProviderClsId

特定提供程序的 REFCLSID。 如果此参数设置为 CLSID_NULL,则将枚举所有提供程序。

[in] dwSupportedArchitecture

以下标志之一或组合,表示要枚举的提供程序的体系结构。 如果指定 了 SYNC_32_BIT_SUPPORTED ,则将枚举支持 32 位或 32 位和 64 位的所有提供程序。 如果指定 SYNC_32_BIT_SUPPORTED | SYNC_64_BIT_SUPPORTED ,则仅枚举同时支持 32 位和 64 位的提供程序。

  • SYNC_32_BIT_SUPPORTED ( (DWORD) 0x00000001)
  • SYNC_64_BIT_SUPPORTED ( (DWORD) 0x00000002)
如果此参数设置为零,则将枚举所有体系结构的同步提供程序。

[out] ppEnumSyncProviderInfos

IEnumSyncProviderInfos 枚举接口,它将枚举与指定条件匹配的所有 ISyncProviderInfo 对象。

返回值

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

返回代码 说明
S_OK
方法成功。
E_POINTER
无效指针。
E_OUTOFMEMORY
内存不足,无法返回枚举接口。

要求

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

另请参阅

IEnumSyncProviderInfos 接口

ISyncProviderRegistration 接口