Export (0) Print
Expand All
Expand Minimize

SHAssocEnumHandlers function

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

Syntax


HRESULT SHAssocEnumHandlers(
  _In_   PCWSTR pszExtra,
  _In_   ASSOC_FILTER afFilter,
  _Out_  IEnumAssocHandlers **ppEnumHandler
);

Parameters

pszExtra [in]

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 [in]

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.

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.

ppEnumHandler [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

Library

Shell32.lib

DLL

Shell32.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft