Поделиться через

Функция SHAssocEnumHandlersForProtocolByApplication (shobjidl_core.h)

  • Статья

Возвращает интерфейс перечисления, предоставляющий доступ к обработчикам, связанным с заданным протоколом.

Синтаксис

SHSTDAPI SHAssocEnumHandlersForProtocolByApplication(
  [in]  PCWSTR protocol,
  [in]  REFIID riid,
  [out] void   **enumHandlers
);

Параметры

[in] protocol

Тип: PCWSTR

Указатель на строку, указывающую протокол.

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, извлекаемого с помощью enumHandlers, обычно IID_IEnumAssocHandlers.

[out] enumHandlers

Тип: void**

При возврате этого метода содержит указатель интерфейса, запрошенный в riid. Обычно это IEnumAssocHandlers.

Возвращаемое значение

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Рекомендуется использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и enumHandlers . Этот макрос предоставляет правильный IID на основе интерфейса, на который указывает значение в enumHandlers, что исключает возможность ошибки кода.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)
Библиотека Shell32.lib
DLL Shell32.dll (версия 6.1 или более поздняя)