PrivateExtractIconsA, fonction (winuser.h)
[Cette fonction n’est pas destinée à une utilisation générale. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]
Crée un tableau de handles aux icônes extraites d’un fichier spécifié.
Syntaxe
UINT PrivateExtractIconsA(
[in] LPCSTR szFileName,
[in] int nIconIndex,
[in] int cxIcon,
[in] int cyIcon,
[out, optional] HICON *phicon,
[out, optional] UINT *piconid,
[in] UINT nIcons,
[in] UINT flags
);
Paramètres
[in] szFileName
Type : LPCTSTR
Chemin d’accès et nom du fichier à partir duquel les icônes doivent être extraites.
[in] nIconIndex
Type : int
Index de base zéro de la première icône à extraire. Par exemple, si cette valeur est égale à zéro, la fonction extrait la première icône dans le fichier spécifié.
[in] cxIcon
Type : int
Taille de l’icône horizontale souhaitée. Voir les remarques.
[in] cyIcon
Type : int
Taille de l’icône verticale souhaitée. Voir les remarques.
[out, optional] phicon
Type : HICON*
Pointeur vers le tableau retourné de poignées d’icônes.
[out, optional] piconid
Type : UINT*
Pointeur vers un identificateur de ressource retourné pour l’icône qui correspond le mieux à l’appareil d’affichage actuel. L’identificateur retourné est 0xFFFFFFFF si l’identificateur n’est pas disponible pour ce format. L’identificateur retourné est 0 si l’identificateur ne peut pas être obtenu autrement.
[in] nIcons
Type : uiNT
Nombre d’icônes à extraire du fichier. Ce paramètre est valide uniquement lors de l’extraction de fichiers .exe et .dll.
[in] flags
Type : uiNT
Spécifie les indicateurs qui contrôlent cette fonction. Ces indicateurs sont les indicateurs LR_* utilisés par la fonction LoadImage
Valeur de retour
Type : uiNT
Si le paramètre phicon est NULL et que cette fonction réussit, la valeur de retour correspond au nombre d’icônes dans le fichier. Si la fonction échoue, la valeur de retour est 0.
Si le paramètre phicon n’est pas NULL et que la fonction réussit, la valeur de retour est le nombre d’icônes extraites. Sinon, la valeur de retour est 0xFFFFFFFF si le fichier est introuvable.
Remarques
Cette fonction extrait des fichiers exécutables (.exe), DLL (.dll), icône (.ico), curseur (.cur), curseur animé (.ani) et bitmap (.bmp). Les extractions à partir d’exécutables Windows 3.x 16 bits (.exe ou .dll) sont également prises en charge.
Les paramètres cxIcon et cyIcon spécifient la taille des icônes à extraire. Deux tailles peuvent être extraites en plaçant la première taille dans le LOWORD du paramètre et la deuxième taille dans HIWORD.
Par exemple, MAKELONG(24, 48) pour les paramètres cxIcon et cyIcon extraient les icônes de taille 24 et 48.
Vous devez détruire toutes les icônes extraites par PrivateExtractIcons en appelant la fonction DestroyIcon.
Cette fonction n’a pas été incluse dans les en-têtes et bibliothèques du Kit de développement logiciel (SDK) tant que Windows XP Service Pack 1 (SP1) et Windows Server 2003. Si vous n’avez pas de fichier d’en-tête et de bibliothèque d’importation pour cette fonction, vous pouvez appeler la fonction à l’aide de LoadLibrary et GetProcAddress.
Note
L’en-tête winuser.h définit PrivateExtractIcons 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 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h |
| bibliothèque | User32.lib |
| DLL | User32.dll |
| ensemble d’API | ext-ms-win-ntuser-misc-l1-5-1 (introduit dans Windows 10, version 10.0.14393) |
Voir aussi
conceptuelle
de référence