SHAssocEnumHandlers function (shobjidl_core.h)

Returns an enumeration object for a specified set of file name extension handlers.

Syntax

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

Parameters

[in] pszExtra

Type: PCWSTR

A pointer to a null-terminated buffer that contains a single file type extension, for instance ".jpg". Only handlers associated with the given extension are enumerated. This parameter may not be NULL.

[in] afFilter

Type: ASSOC_FILTER

Specifies the enumeration handler filter applied to the full list of handlers that results from the value given in pszExtra. One of the following values.

Value	Description
ASSOC_FILTER_NONE	Return all handlers.
ASSOC_FILTER_RECOMMENDED	Return only recommended handlers. A handler sets its recommended status in the registry when it is installed. An initial status of non-recommended can later be promoted to recommended as a result of user action.

[out] ppEnumHandler

Type: IEnumAssocHandlers**

When this method returns, contains the address of a pointer to an IEnumAssocHandlers object.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)
Library	Shell32.lib
DLL	Shell32.dll