SHCreateShellFolderViewEx-Funktion (shlobj_core.h)

  • Artikel

Erstellt eine neue instance des Standardobjekts der Shellordneransicht. Es wird empfohlen, shCreateShellFolderView anstelle dieser Funktion zu verwenden.

Syntax

SHSTDAPI SHCreateShellFolderViewEx(
  [in]  CSFV       *pcsfv,
  [out] IShellView **ppsv
);

Parameter

[in] pcsfv

Typ: CSFV*

Zeiger auf eine Struktur, die die Details beschreibt, die beim Erstellen dieses instance des Shell-Ordneransichtsobjekts verwendet werden.

[out] ppsv

Typ: IShellView**

Die Adresse eines IShellView-Schnittstellenzeigers , der bei erfolgreicher Rückgabe dieser Funktion auf das neue Ansichtsobjekt verweist. 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 hierzu QueryInterface für das Objekt auf, indem Sie IID_CDefView verwenden. Dieser Aufruf ist nur für das Standardmäßige Shell-Ordneransichtsobjekt erfolgreich.

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)

Weitere Informationen

SHCreateShellFolderView