função Shell_GetCachedImageIndexA (shlobj_core.h)
[Shell_GetCachedImageIndex está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use Shell_GetCachedImageIndexA ou Shell_GetCachedImageIndexW.]
Recupera o índice de cache de um ícone armazenado em cache.
Sintaxe
int Shell_GetCachedImageIndexA(
LPCSTR pszIconPath,
int iIconIndex,
UINT uIconFlags
);
Parâmetros
pszIconPath
TBD
iIconIndex
Tipo: int
O índice da imagem dentro do arquivo nomeado em pwszIconPath.
uIconFlags
Tipo: UINT
Não usado.
Valor de retorno
Tipo: int
Retorna o índice da imagem ou –1 em caso de falha.
Observações
As versões Shell_GetCachedImageIndexA e Shell_GetCachedImageIndexW dessa função foram adicionadas ao Windows Vista. Para cadeias de caracteres Unicode, chame Shell_GetCachedImageIndexW ou Shell_GetCachedImageIndex. Para cadeias de caracteres ANSI, você deve chamar Shell_GetCachedImageIndexA explicitamente.
Windows Server 2003 e Windows XP: somente Shell_GetCachedImageIndex tem suporte. Shell_GetCachedImageIndex requer uma cadeia de caracteres Unicode.
Nota
O cabeçalho shlobj_core.h define Shell_GetCachedImageIndex como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | shlobj_core.h (inclua Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h) |
| biblioteca | Shell32.lib |
| de DLL |
Shell32.dll (versão 5.0 ou posterior) |
| conjunto de API | ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240) |