SHAssocEnumHandlers function

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

Syntax

SHSTDAPI SHAssocEnumHandlers(
  PCWSTR             pszExtra,
  ASSOC_FILTER       afFilter,
  IEnumAssocHandlers **ppEnumHandler
);

Parameters

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. If this value is NULL, all handlers for all extensions are enumerated.

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.

ASSOC_FILTER_NONE

Return all handlers.

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.

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

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
Library Shell32.lib
DLL Shell32.dll