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) |