Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |