Функция 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