SHCreateShellFolderView-Funktion (shlobj_core.h)
Erstellt eine neue instance des Standardmäßigen Shell-Ordneransichtsobjekts (DefView).
Syntax
SHSTDAPI SHCreateShellFolderView(
[in] const SFV_CREATE *pcsfv,
[out] IShellView **ppsv
);
Parameter
[in] pcsfv
Typ: const SFV_CREATE*
Zeiger auf eine SFV_CREATE-Struktur, die die Beim Erstellen dieser instance des Shell-Ordneransichtsobjekts verwendeten Angaben beschreibt.
[out] ppsv
Typ: IShellView**
Wenn diese Funktion erfolgreich zurückgegeben wird, enthält einen Schnittstellenzeiger auf das neue IShellView-Objekt . Bei einem Fehler ist dieser Wert NULL.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
SHCreateShellFolderView wird über SHCreateShellFolderViewEx empfohlen, da die Elemente flexibler sind, um an verschiedenen Szenarien teilzunehmen, neue Funktionen für die Ansicht bereitzustellen und mit anderen Objekten zu interagieren.
Wenn Sie sich mit mehreren Instanzen von IShellView befassen, sollten Sie überprüfen, welches das Standardmäßige Shell-Ordneransichtsobjekt ist. Rufen Sie dazu QueryInterface für das -Objekt auf, indem Sie die IID_CDefView IID verwenden. Dieser Aufruf ist nur erfolgreich, wenn er für das Standardmäßige Shell-Ordneransichtsobjekt ausgeführt wird.
Datenquellen, die das Standardmäßige Shell-Ordneransichtsobjekt verwenden, müssen diese Schnittstellen implementieren:
Optional können sie auch IPersistFolder3 implementieren.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h (shlobj.h einschließen) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 5.0 oder höher) |
| APIs | ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393) |