Função SHMapPIDLToSystemImageListIndex (shlobj_core.h)

Artigo
08/26/2023

[SHMapPIDLToSystemImageListIndex está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Recupera o índice de ícones da lista de imagens do sistema associada a um item de pasta.

Sintaxe

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

Parâmetros

[in] pshf

Tipo: IShellFolder*

Um ponteiro de interface IShellFolder para a pasta que contém o item.

[in] pidl

Tipo: PCUITEMID_CHILD

Um ponteiro para a estrutura ITEMIDLIST do item.

[out, optional] piIndexSel

Tipo: int*

Um ponteiro para um int que, quando essa função retorna com êxito, recebe o índice do ícone aberto do item na lista de imagens do sistema. Se o item não tiver um ícone aberto especial, o índice de seu ícone normal será retornado. Se o ícone aberto existir e não puder ser obtido, o valor apontado por piIndex será definido como -1. Esse parâmetro poderá ser NULL se o aplicativo de chamada não estiver interessado no ícone aberto .

Valor retornado

Tipo: int

Retorna o índice do ícone normal do item na lista de imagens do sistema se tiver êxito ou -1 caso contrário.

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
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)