Função SHAssocEnumHandlers (shobjidl_core.h)

  • Artigo

Retorna um objeto de enumeração para um conjunto especificado de manipuladores de extensão de nome de arquivo.

Sintaxe

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

Parâmetros

[in] pszExtra

Tipo: PCWSTR

Um ponteiro para um buffer encerrado em nulo que contém uma única extensão de tipo de arquivo, por exemplo, ".jpg". Somente manipuladores associados à extensão fornecida são enumerados. Esse parâmetro pode não ser NULL.

[in] afFilter

Tipo: ASSOC_FILTER

Especifica o filtro de manipulador de enumeração aplicado à lista completa de manipuladores resultantes do valor fornecido em pszExtra. Um dos valores a seguir.

Valor Descrição
ASSOC_FILTER_NONE Retornar todos os manipuladores.
ASSOC_FILTER_RECOMMENDED Retornar somente manipuladores recomendados. Um manipulador define seu status recomendado no registro quando ele é instalado. Um status inicial de não recomendado pode ser promovido posteriormente para recomendado como resultado da ação do usuário.

[out] ppEnumHandler

Tipo: IEnumAssocHandlers**

Quando esse método retorna, contém o endereço de um ponteiro para um objeto 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.

Requisitos

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