PrivateExtractIconsW, 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 PrivateExtractIconsW(
[in] LPCWSTR 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 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 les 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. Vous pouvez extraire deux tailles en plaçant la première taille dans le LOWORD du paramètre et la deuxième taille dans hiword.
Par exemple, pour les paramètres cxIcon et cyIcon, MAKELONG(24, 48) les icônes de taille 24 et 48 sont extraites.
Vous devez détruire toutes les icônes extraites par PrivateExtractIcons en appelant la fonction DestroyIcon .
Cette fonction n’était pas incluse dans les en-têtes et bibliothèques du SDK jusqu’à 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 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
| 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