PrivateExtractIconsA, fonction (winuser.h)

Article
08/27/2023

[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)