função Shell_GetCachedImageIndexA (shlobj_core.h)

  • Artigo

[Shell_GetCachedImageIndex está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar 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 chamado em pwszIconPath.

uIconFlags

Tipo: UINT

Não usado.

Valor retornado

Tipo: int

Retorna o índice da imagem ou –1 em caso de falha.

Comentários

As versões Shell_GetCachedImageIndexA e Shell_GetCachedImageIndexW dessa função foram adicionadas no 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: Há suporte apenas para Shell_GetCachedImageIndex . Shell_GetCachedImageIndex requer uma cadeia de caracteres Unicode.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows XP [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 shlobj_core.h (inclua Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)
Conjunto de APIs ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)

Confira também

FileIconInit