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

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

  • Статья

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

Синтаксис

SHSTDAPI SHAssocEnumHandlers(
  [in]  PCWSTR             pszExtra,
  [in]  ASSOC_FILTER       afFilter,
  [out] IEnumAssocHandlers **ppEnumHandler
);

Параметры

[in] pszExtra

Тип: PCWSTR

Указатель на буфер, заканчивающийся значением NULL, который содержит одно расширение типа файла, например ".jpg". Перечисляются только обработчики, связанные с заданным расширением. Этот параметр не может иметь значение NULL.

[in] afFilter

Тип: ASSOC_FILTER

Указывает фильтр обработчика перечисления, применяемый к полному списку обработчиков, который является результатом значения, заданного в pszExtra. Одно из следующих значений.

Значение Описание
ASSOC_FILTER_NONE Возвращает все обработчики.
ASSOC_FILTER_RECOMMENDED Возвращает только рекомендуемые обработчики. Обработчик задает рекомендуемое состояние в реестре при установке. Первоначальное состояние нерекомендовать позже можно повысить до рекомендованного в результате действий пользователя.

[out] ppEnumHandler

Тип: IEnumAssocHandlers**

При возврате этим методом содержит адрес указателя на объект IEnumAssocHandlers .

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

Тип: HRESULT

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

Требования

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