Fonction SHCreateShellFolderView (shlobj_core.h)
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) |