Función SHAssocEnumHandlers (shobjidl_core.h)

  • Artículo

Devuelve un objeto de enumeración para un conjunto especificado de controladores de extensión de nombre de archivo.

Sintaxis

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

Parámetros

[in] pszExtra

Tipo: PCWSTR

Puntero a un búfer terminado en null que contiene una única extensión de tipo de archivo, por ejemplo, ".jpg". Solo se enumeran los controladores asociados a la extensión especificada. Este parámetro puede no ser NULL.

[in] afFilter

Tipo: ASSOC_FILTER

Especifica el filtro del controlador de enumeración aplicado a la lista completa de controladores resultantes del valor especificado en pszExtra. Uno de los siguientes valores.

Valor Descripción
ASSOC_FILTER_NONE Devuelve todos los controladores.
ASSOC_FILTER_RECOMMENDED Devuelve solo los controladores recomendados. Un controlador establece su estado recomendado en el Registro cuando se instala. Posteriormente, se puede promover un estado inicial de no recomendado a recomendado como resultado de la acción del usuario.

[out] ppEnumHandler

Tipo: IEnumAssocHandlers**

Cuando este método devuelve, contiene la dirección de un puntero a un objeto IEnumAssocHandlers .

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Library Shell32.lib
Archivo DLL Shell32.dll