Compartir a través de

Función SHAssocEnumHandlersForProtocolByApplication (shobjidl_core.h)

  • Artículo

Obtiene una interfaz de enumeración que proporciona acceso a los controladores asociados a un protocolo determinado.

Sintaxis

SHSTDAPI SHAssocEnumHandlersForProtocolByApplication(
  [in]  PCWSTR protocol,
  [in]  REFIID riid,
  [out] void   **enumHandlers
);

Parámetros

[in] protocol

Tipo: PCWSTR

Puntero a una cadena que especifica el protocolo.

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz que se va a recuperar a través de enumHandlers, normalmente IID_IEnumAssocHandlers.

[out] enumHandlers

Tipo: void**

Cuando este método vuelve, contiene el puntero de interfaz solicitado en riid. Esto suele ser 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.

Comentarios

Se recomienda usar la macro IID_PPV_ARGS , definida en Objbase.h, para empaquetar los parámetros riid y enumHandlers . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor de enumHandlers, lo que elimina la posibilidad de un error de codificación.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 6.1 o posterior)