Partager via

SHMapPIDLToSystemImageListIndex, fonction (shlobj_core.h)

  • Article

[SHMapPIDLToSystemImageListIndex est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Récupère l’index d’icône de la liste d’images système associée à un élément de dossier.

Syntaxe

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

Paramètres

[in] pshf

Type : IShellFolder*

Pointeur d’interface IShellFolder pour le dossier qui contient l’élément.

[in] pidl

Type : PCUITEMID_CHILD

Pointeur vers la structure ITEMIDLIST de l’élément.

[out, optional] piIndexSel

Type : int*

Pointeur vers un int qui, lorsque cette fonction retourne correctement, reçoit l’index de l’icône ouverte de l’élément dans la liste d’images système. Si l’élément n’a pas d’icône ouverte spéciale, l’index de son icône normale est retourné. Si l’icône ouverte existe et ne peut pas être obtenue, la valeur pointée par piIndex est définie sur -1. Ce paramètre peut avoir la valeur NULL si l’application appelante n’est pas intéressée par l’icône d’ouverture .

Valeur retournée

Type : int

Renvoie l’index de l’icône normale de l’élément dans la liste d’images système en cas de réussite, ou -1 dans le cas contraire.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h
Bibliothèque Shell32.lib
DLL Shell32.dll (version 5.0 ou ultérieure)