Partager via

SHExtractIconsW, fonction

  • Article

Permet de créer un tableau de poignées aux icônes extraites d’un fichier spécifié.

Remarque

Cette fonction est disponible via Windows XP Service Pack 2 (SP2). Il est possible qu’elle soit modifiée ou indisponible dans des versions ultérieures. Utilisez plutôt la fonction SHDefExtractIcon.

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 [in]

Type : LPCWSTR

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

nIconIndex [in]

Type : int

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

cxIcon [in]

Type : int

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

cyIcon [in]

Type : int

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

phIcon [out]

Type : HICON*

Lorsque cette fonction retourné, contient un pointeur vers le tableau de poignées d’icônes.

pIconId [out]

Type : UINT*

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

nIcons [in]

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 [in]

Type : UINT

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

Valeur retournée

Type : UINT

Valeur autre que zéro en cas de réussite, sinon zéro.

Notes

SHExtractIconsW extrait les types de fichiers suivants.

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

Les extractions à partir des fichiers exécutables Windows 3.x 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 via chaque paramètre en fractionnant la valeur entre son LOWORD et son 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 de taille 24 et 48.

Le processus appelant est chargé de détruire toutes les icônes extraites par 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 que vous pouvez utiliser pour appeler cette fonction.

Spécifications

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