SHAssocEnumHandlers function (shobjidl_core.h)

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


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


[in] pszExtra


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


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


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


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