SHGetStockIconInfo, fonction (shellapi.h)

Récupère des informations sur les icônes Shell définies par le système.

Syntaxe

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

Paramètres

siid

Type : SHSTOCKICONID

Une des valeurs de l’énumération SHSTOCKICONID qui spécifie l’icône à récupérer.

uFlags

Type : UINT

Combinaison de zéro ou plusieurs des indicateurs suivants qui spécifient les informations demandées.

SHGSI_ICONLOCATION

Les membres szPath et iIcon de la structure SHSTOCKICONINFO reçoivent le chemin d’accès et l’index d’icône de l’icône demandée, dans un format approprié pour passer à la fonction ExtractIcon . La valeur numérique de cet indicateur étant zéro, vous obtenez toujours l’emplacement de l’icône, quels que soient les autres indicateurs.

SHGSI_ICON

Le membre hIcon de la structure SHSTOCKICONINFO reçoit un handle à l’icône spécifiée.

SHGSI_SYSICONINDEX

Le membre iSysImageImage de la structure SHSTOCKICONINFO reçoit l’index de l’icône spécifiée dans la liste d’images système.

SHGSI_LINKOVERLAY

Modifie la valeur SHGSI_ICON en obligeant la fonction à ajouter la superposition de lien à l’icône du fichier.

SHGSI_SELECTED

Modifie la valeur SHGSI_ICON en faisant fusionner l’icône avec la couleur de surbrillance système.

SHGSI_LARGEICON

Modifie la valeur SHGSI_ICON en faisant en sorte que la fonction récupère la version volumineuse de l’icône, comme spécifié par les métriques système SM_CXICON et SM_CYICON.

SHGSI_SMALLICON

Modifie la valeur SHGSI_ICON en faisant en sorte que la fonction récupère la petite version de l’icône, comme spécifié par les métriques système SM_CXSMICON et SM_CYSMICON.

SHGSI_SHELLICONSIZE

Modifie les valeurs SHGSI_LARGEICON ou SHGSI_SMALLICON en obligeant la fonction à récupérer les icônes de la taille de l’interpréteur de commandes plutôt que les tailles spécifiées par les métriques système.

[in, out] psii

Type : SHSTOCKICONINFO*

Pointeur vers une structure SHSTOCKICONINFO . Lorsque cette fonction est appelée, le membre cbSize de cette structure doit être défini sur la taille de la structure SHSTOCKICONINFO . Lorsque cette fonction retourne, contient un pointeur vers une structure SHSTOCKICONINFO qui contient les informations demandées.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si cette fonction retourne un handle d’icône dans le membre hIcon de la structure SHSTOCKICONINFO pointée par psii, vous êtes responsable de libérer l’icône avec DestroyIcon lorsque vous n’en avez plus besoin.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shellapi.h
DLL	Shell32.dll
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240)