Fonction SHCreateShellFolderView (shlobj_core.h)

  • Article

Crée une instance de l’objet d’affichage de dossier Shell par défaut (DefView).

Syntaxe

SHSTDAPI SHCreateShellFolderView(
  [in]  const SFV_CREATE *pcsfv,
  [out] IShellView       **ppsv
);

Paramètres

[in] pcsfv

Type : const SFV_CREATE*

Pointeur vers une structure de SFV_CREATE qui décrit les informations utilisées dans la création de cette instance de l’objet d’affichage de dossier Shell.

[out] ppsv

Type : IShellView**

Lorsque cette fonction retourne correctement, contient un pointeur d’interface vers le nouvel objet IShellView . En cas d’échec, cette valeur est NULL.

Valeur retournée

Type : HRESULT

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

Remarques

SHCreateShellFolderView est recommandé par rapport à SHCreateShellFolderViewEx en raison de la plus grande flexibilité de ses éléments pour participer à différents scénarios, fournir de nouvelles fonctionnalités à la vue et interagir avec d’autres objets.

Lorsque vous traitez avec plusieurs instances d’IShellView, vous pouvez vérifier qui est l’objet d’affichage de dossier Shell par défaut. Pour ce faire, appelez QueryInterface sur l’objet à l’aide du IID_CDefView IID. Cet appel réussit uniquement lorsqu’il est effectué sur l’objet d’affichage de dossier Shell par défaut.

Les sources de données qui utilisent l’objet d’affichage de dossiers Shell par défaut doivent implémenter les interfaces suivantes :

Éventuellement, ils peuvent également implémenter IPersistFolder3.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [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 (inclure Shlobj.h)
Bibliothèque Shell32.lib
DLL Shell32.dll (version 5.0 ou ultérieure)
Ensemble d’API ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

SFV_CREATE

SHCreateShellFolderViewEx