Fonction SHCreateFileExtractIconW (shlobj_core.h)

Article
03/04/2024

[SHCreateFileExtractIcon est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Crée un gestionnaire IExtractIcon par défaut pour un objet de système de fichiers. Les extensions d’espace de noms qui affichent des objets de système de fichiers utilisent généralement cette fonction. L’extension et les attributs de fichier dérivent tout ce qui est nécessaire pour un extracteur d’icône simple.

Syntaxe

SHSTDAPI SHCreateFileExtractIconW(
  [in] LPCWSTR pszFile,
  [in] DWORD   dwFileAttributes,
  [in] REFIID  riid,
       void    **ppv
);

Paramètres

[in] pszFile

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui spécifie l’objet de système de fichiers. La mémoire tampon ne doit pas dépasser MAX_PATH caractères.

[in] dwFileAttributes

Type : DWORD

Combinaison d’un ou plusieurs indicateurs d’attribut de fichier (valeurs FILE_ATTRIBUTE_* telles que définies dans Winnt.h) qui spécifient le type d’objet.

[in] riid

Type : REFIID

Référence à l’ID d’interface souhaité de l’interface d’extracteur d’icône à créer. Cela doit être IID_IExtractIconA ou IID_IExtractIconW.

ppv

Type : void**

Lorsque cette fonction retourne, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IExtractIcon.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via