Função SHAssocEnumHandlersForProtocolByApplication (shobjidl_core.h)

Obtém uma interface de enumeração que fornece acesso a manipuladores associados a um determinado protocolo.

Sintaxe

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

Parâmetros

[in] protocol

Tipo: PCWSTR

Ponteiro para uma cadeia de caracteres que especifica o protocolo.

[in] riid

Tipo: REFIID

Uma referência à IID da interface a ser recuperada por meio de enumHandlers, normalmente IID_IEnumAssocHandlers.

[out] enumHandlers

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IEnumAssocHandlers.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

É recomendável que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e enumHandlers . Essa macro fornece o IID correto com base na interface apontada pelo valor em enumHandlers, o que elimina a possibilidade de um erro de codificação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 6.1 ou posterior)