ExtractAssociatedIconExW, fonction (shellapi.h)

Article
11/20/2024

[ExtractAssociatedIconEx 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.]

Obtient un handle vers une icône stockée sous forme de ressource dans un fichier ou une icône stockée dans le fichier exécutable associé d’un fichier. Il étend la fonction ExtractAssociatedIcon en récupérant l’ID de l’icône lorsque cette icône est extraite d’un fichier exécutable.

Syntaxe

HICON ExtractAssociatedIconExW(
  [in]      HINSTANCE hInst,
  [in, out] LPWSTR    pszIconPath,
  [in, out] WORD      *piIconIndex,
  [in, out] WORD      *piIconId
);

Paramètres

[in] hInst

Type : HINSTANCE

Handle du module à partir duquel extraire l’icône.

[in, out] pszIconPath

Type : LPTSTR

Pointeur vers une chaîne qui, lors de l’entrée, spécifie le chemin d’accès complet et le nom de fichier du fichier qui contient l’icône. La fonction extrait le handle d’icône de ce fichier ou d’un fichier exécutable associé à ce fichier.

Lorsque cette fonction est retournée, si le handle d’icône a été obtenu à partir d’un fichier exécutable (un fichier exécutable directement pointé par ce paramètre ou un fichier exécutable associé), la fonction stocke le chemin d’accès complet et le nom de fichier de cet exécutable dans la mémoire tampon pointée par ce paramètre.

[in, out] piIconIndex

Type : LPWORD

Pointeur vers une valeur WORD qui, lors de l’entrée, spécifie l’index de l’icône dont le handle doit être obtenu.

Lorsque la fonction est retournée, si le handle d’icône a été obtenu à partir d’un fichier exécutable (un fichier exécutable pointé par lpIconPath ou un fichier exécutable associé), cette valeur pointe vers l’index de l’icône dans ce fichier.

[in, out] piIconId

Type : LPWORD

Pointeur vers une valeur WORD qui, lors de l’entrée, spécifie l’ID de l’icône dont le handle doit être obtenu.

Valeur de retour

Type : HICON

Retourne le handle de l’icône en cas de réussite, sinon NULL.

Remarques

Le handle d’icône retourné par cette fonction doit être libéré en appelant DestroyIcon lorsqu’il n’est plus nécessaire.

Note

L’en-tête shellapi.h définit ExtractAssociatedIconEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shellapi.h
bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx

Partager via