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 介面