Função AssocGetPerceivedType (shlwapi.h)

Recupera o tipo percebido de um arquivo com base em sua extensão.

Sintaxe

LWSTDAPI AssocGetPerceivedType(
  [in]            PCWSTR        pszExt,
  [out]           PERCEIVED     *ptype,
  [out]           PERCEIVEDFLAG *pflag,
  [out, optional] PWSTR         *ppszType
);

Parâmetros

[in] pszExt

Tipo: PCWSTR

Um ponteiro para um buffer que contém a extensão do arquivo. Isso deve incluir o período à esquerda, por exemplo, ".txt".

[out] ptype

Tipo: PERCEBIDO*

Um ponteiro para um valor PERCEIVED que indica o tipo percebido.

[out] pflag

Tipo: PERCEIVEDFLAG*

Um ponteiro para um valor que indica a origem das informações de tipo percebidas. Um ou mais dos valores a seguir.

PERCEIVEDFLAG_UNDEFINED (0x0000)

Nenhum tipo percebido foi encontrado (PERCEIVED_TYPE_UNSPECIFIED).

PERCEIVEDFLAG_SOFTCODED (0x0001)

O tipo percebido foi determinado por meio de uma associação no registro.

PERCEIVEDFLAG_HARDCODED (0x0002)

O tipo percebido é inerentemente conhecido pelo Windows.

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

O tipo percebido foi determinado por meio de um codec fornecido com o Windows.

PERCEIVEDFLAG_GDIPLUS (0x0010)

O tipo percebido é compatível com a biblioteca GDI+.

PERCEIVEDFLAG_WMSDK (0x0020)

O tipo percebido é compatível com o SDK do Windows Media.

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

O tipo percebido é compatível com pastas compactadas do Windows.

[out, optional] ppszType

Tipo: PWSTR*

Se a função retornar um código de êxito, ela conterá o endereço de um ponteiro para um buffer que recebe a cadeia de caracteres de tipo percebida, por exemplo , "text" ou "video". Esse valor pode ser NULL.

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

Essa função primeiro compara a extensão com um conjunto embutido em código de extensões conhecidas pelo Windows. Se essa pesquisa não revelar uma correspondência, as associações registradas em HKEY_CLASSES_ROOT serão pesquisadas por uma chave que corresponda à extensão e contenha um valor PerceivedType. Se esse valor for encontrado, o conjunto de extensões será novamente pesquisado para obter uma correspondência. Se novamente nenhuma correspondência for encontrada, o tipo percebido será determinado como PERCEIVED_TYPE_CUSTOM. Se uma chave que corresponde à extensão ou um valor PerceivedType não for encontrada, o tipo percebido será relatado como PERCEIVED_TYPE_UNSPECIFIED.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 6.0 ou posterior)