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 vers des 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 d’icône horizontale souhaitée. Consultez la section Notes.
[in] cyIcon
Type : int
Taille d’icône verticale souhaitée. Consultez la section Notes.
[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 retournée
Type : UINT
Si le paramètre phicon a la valeur NULL et que cette fonction réussit, la valeur de retour est le 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 correspond au 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 dans hiWORD.
Par exemple, MAKELONG(24, 48) 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 bibliothèques et en-têtes du Kit de développement logiciel (SDK) avant 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 en utilisant LoadLibrary et GetProcAddress.
Notes
L’en-tête winuser.h définit PrivateExtractIcons comme un 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.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| 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
Conceptuel
Référence