ExtractAssociatedIconA, fonction (shellapi.h)
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.
Syntaxe
HICON ExtractAssociatedIconA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIcon
);
Paramètres
[in] hInst
Type : HINSTANCE
Handle de l’instance de l’application appelante.
[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 pointé par lpIconPath 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] piIcon
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.
Valeur de retour
Type : HICON
Si la fonction réussit, la valeur de retour est un handle d’icône. Si l’icône est extraite d’un fichier exécutable associé, la fonction stocke le chemin d’accès complet et le nom de fichier du fichier exécutable dans la chaîne pointée par lpIconPath, et stocke l’identificateur de l’icône dans l'WORD pointé par lpiIcon.
Si la fonction échoue, la valeur de retour est NULL .
Remarques
Lorsqu’il n’est plus nécessaire, l’appelant est chargé de libérer le handle d’icône retourné par
La fonction ExtractAssociatedIcon recherche d’abord l’icône indexée dans le fichier spécifié par lpIconPath. Si la fonction ne peut pas obtenir le handle d’icône de ce fichier et que le fichier possède un fichier exécutable associé, il recherche dans ce fichier exécutable une icône. Les associations avec des fichiers exécutables sont basées sur les extensions de nom de fichier et sont stockées dans la partie par utilisateur du Registre.
Note
L’en-tête shellapi.h définit ExtractAssociatedIcon 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 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’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) |