Метод ISyncProviderRegistration::EnumerateSyncProviders (syncregistration.h)

Статья
08/26/2023

Возвращает интерфейс перечисления 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
Header	syncregistration.h

См. также раздел

Интерфейс IEnumSyncProviderInfos

Интерфейс ISyncProviderRegistration