SHCreateShellFolderView-Funktion (shlobj_core.h)

  • Artikel

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)

Weitere Informationen

SFV_CREATE

SHCreateShellFolderViewEx