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 plus 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 adapté à la transmission à la fonction ExtractIcon . La valeur numérique de cet indicateur est égale à zéro. Vous obtenez donc toujours l’emplacement de l’icône indépendamment des 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 provoquant l’ajout de la superposition de liens à l’icône du fichier.

SHGSI_SELECTED

Modifie la valeur SHGSI_ICON en provoquant la fusion de l’icône avec la couleur de mise en surbrillance du système.

SHGSI_LARGEICON

Modifie la valeur SHGSI_ICON en provoquant la récupération de 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 provoquant la récupération de 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 provoquant la récupération des icônes de taille Shell 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 est retournée, 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 quand vous n’en avez plus besoin.

Spécifications