SHExtractIconsW fonction)

[SHExtractIconsW est disponible via Windows XP Service Pack 2 (SP2). Il peut être modifié ou non disponible dans les versions ultérieures.]

Crée un tableau de handles pour les icônes extraites d’un fichier spécifié.

Syntaxe

UINT SHExtractIconsW(
  _In_  LPCWSTR pszFileName,
  _In_  int     nIconIndex,
  _In_  int     cxIcon,
  _In_  int     cyIcon,
  _Out_ HICON   *phIcon,
  _Out_ UINT    *pIconId,
  _In_  UINT    nIcons,
  _In_  UINT    flags
);

Paramètres

pszFileName [ dans]

Type : LPCWSTR

Pointeur vers le nom de fichier à partir duquel extraire les icônes.

nIconIndex [ dans]

Type : int

Index de la première icône à extraire de la ressource nommée dans pszFileName.

cxIcon [ dans]

Type : int

Largeur souhaitée de l’icône. Consultez la section Notes.

cyIcon [ dans]

Type : int

Hauteur souhaitée de l’icône. Consultez la section Notes.

phIcon [ à]

Type : HICON *

Lorsque cette fonction est retournée, contient un pointeur vers le tableau de handles d’icône.

pIconId [ à]

Type : uint *

Lorsque cette fonction est retournée, contient un pointeur vers l’identificateur de ressource de l’icône extraite qui correspond le mieux au périphérique d’affichage actuel. Si aucun identificateur n’est disponible pour ce format, il contient 0xFFFFFFFF. Si aucun identificateur ne peut être obtenu pour une autre raison, retourne la valeur zéro.

nIcons [ dans]

Type : uint

Nombre d’icônes à extraire de la ressource nommée dans pszFileName. Ce paramètre est valide uniquement lorsque la ressource est un fichier. exe ou. dll.

indicateurs [ dans]

Type : uint

Indicateurs qui contrôlent cette fonction. Pour connaître les valeurs possibles, consultez le paramètre fuLoad de la fonction LoadImage .

Valeur renvoyée

Type : uint

Valeur différente de zéro en cas de réussite ; Sinon, zéro.

Notes

SHExtractIconsW extrait des types de fichiers suivants.

  • Fichier exécutable (.exe)
  • DLL (. dll)
  • Icône (. ico)
  • Curseur (. cur)
  • Curseur animé (. ani)
  • Bitmap (.bmp)

Extractions à partir de Windows 3. x les fichiers exécutables 16 bits (. exe ou. dll) sont également pris en charge.

Les paramètres cxIcon et cyIcon spécifient la taille des icônes à extraire. Deux tailles peuvent être extraites par le biais de chaque paramètre en fractionnant la valeur entre ses LOWORD et HIWORD. Placez la première taille souhaitée dans le LOWORD du paramètre et la deuxième taille dans le HIWORD. Par exemple, MAKELONG(24, 48) pour cxIcon et cyIcon extrait les icônes 24 et 48.

Le processus appelant est responsable de la destruction de toutes les icônes extraites par le biais de cette fonction en appelant la fonction DestroyIcon .

SHExtractIconsW n’est pas exporté par nom ou déclaré dans un fichier d’en-tête public. Pour l’utiliser, vous devez déclarer un prototype correspondant et utiliser GetProcAddress pour demander un pointeur de fonction à partir de Shell32.dll qui peut être utilisé pour appeler cette fonction.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 professionnel, applications de [ Bureau Windows XP uniquement]
Serveur minimal pris en charge
Applications de bureau Windows Server 2003 [ uniquement]
DLL
Shell32.dll (version 5,0 ou ultérieure)
Noms Unicode et ANSI
SHExtractIconsW (Unicode)