IExtractIconA ::Extract, méthode (shlobj_core.h)

Article
03/02/2024

Extrait une image d’icône à partir de l’emplacement spécifié.

Syntaxe

HRESULT Extract(
  [in]            PCSTR pszFile,
                  UINT  nIconIndex,
  [out, optional] HICON *phiconLarge,
  [out, optional] HICON *phiconSmall,
                  UINT  nIconSize
);

Paramètres

[in] pszFile

Type : PCTSTR

Pointeur vers une chaîne terminée par null qui spécifie l’emplacement de l’icône.

nIconIndex

Type : UINT

Index de l’icône dans le fichier pointé vers pszFile.

[out, optional] phiconLarge

Type : HICON*

Pointeur vers une valeur HICON qui reçoit le handle de la grande icône. Ce paramètre peut être NULL.

[out, optional] phiconSmall

Type : HICON*

Pointeur vers une valeur HICON qui reçoit le handle de la petite icône. Ce paramètre peut être NULL.

nIconSize

Type : UINT

Taille souhaitée de l’icône, en pixels. Le mot bas contient la taille de la grande icône, et le mot haut contient la taille de la petite icône. La taille spécifiée peut être la largeur ou la hauteur. La largeur d’une icône est toujours égale à sa hauteur.

Valeur retournée

Type : HRESULT

Retourne S_OK si la fonction a extrait l’icône, ou S_FALSE si l’application appelante doit extraire l’icône.

Remarques

L’emplacement et l’index de l’icône sont les mêmes valeurs que celles retournées par la méthode IExtractIcon ::GetIconLocation . Si la fonction IExtractIcon ::Extract retourne S_FALSE, ces valeurs doivent spécifier un nom de fichier d’icône et un index qui forment des paramètres juridiques pour un appel à ExtractIcon. Si IExtractIcon ::Extract ne retourne pas S_FALSE, aucune hypothèse ne doit être faite concernant la signification des paramètres pszFile et nIconIndex .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h
DLL	Shell32.dll (version 4.0 ou ultérieure)

Voir aussi

IExtractIcon

Partager via