Méthode IExtractIconW::Extract (shlobj_core.h)
Extrait une image d’icône de l’emplacement spécifié.
Syntaxe
HRESULT Extract(
[in] PCWSTR 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 vers l’icône de grande taille. Ce paramètre peut avoir la valeur NULL.
[out, optional] phiconSmall
Type : HICON*
Pointeur vers une valeur HICON qui reçoit le handle vers la petite icône. Ce paramètre peut avoir la valeur 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 de l’icône et l’index sont les mêmes valeurs 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
| 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) |