Fonction ExtractAssociatedIconExA (shellapi.h)

  • Article

[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 pour une icône stockée en tant que ressource dans un fichier ou une icône stockée dans le fichier exécutable associé à un fichier. Elle é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 ExtractAssociatedIconExA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     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 ce fichier exécutable dans la mémoire tampon vers laquelle pointe 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 retourne, 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.

Lorsque la fonction retourne, 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’ID de l’icône dans ce fichier.

Valeur retournée

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 quand il n’est plus nécessaire.

Notes

L’en-tête shellapi.h définit ExtractAssociatedIconEx en tant qu’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. La combinaison 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.

Configuration requise

Condition requise Valeur
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 shellapi.h
Bibliothèque Shell32.lib
DLL Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx