IShellView2::CreateViewWindow2-Methode (shobjidl_core.h)

  • Artikel

Wird verwendet, um die Erstellung eines neuen Shellansichtsfensters anzufordern. Dies kann entweder der rechte Bereich von Windows Explorer oder das Clientfenster eines Ordnerfensters sein.

Syntax

HRESULT CreateViewWindow2(
  LPSV2CVW2_PARAMS lpParams
);

Parameter

lpParams

Typ: LPSV2CVW2_PARAMS

Ein Zeiger auf eine SV2CVW2_PARAMS-Struktur , die das neue Ansichtsfenster definiert.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung einen Erfolgscode oder andernfalls einen COM-Fehlercode zurück. Verwenden Sie die Makros SUCCEEDED und FAILED , um zu bestimmen, ob der Vorgang erfolgreich oder fehlgeschlagen ist.

Hinweise

Diese Methode ersetzt CreateViewWindow. Mit CreateViewWindow2 sind Entwickler nicht auf die von CreateViewWindow bereitgestellten Standardansichtsmodi beschränkt, sondern können auch eigene erstellen. Alle Ansichtsmodi werden jetzt durch ihre GUID identifiziert.

Die Größe der Struktur, des vorherigen Ansichtsfensters, der Ordnereinstellungen, des übergeordneten Shell-Browsers und des Ansichtsrechtecks werden in den ersten fünf Mitgliedern von lpParams an IShellView2::CreateViewWindow2 übergeben. Die -Methode ist für das Erstellen des neuen Fensters und die Übergabe des Fensterhandles und der GUID des Ansichtsmodus in den letzten beiden Parametern verantwortlich. IShellView2::CreateViewWindow2 sollte die IShellBrowser::AddRef-Methode des übergeordneten Browsers aufrufen und den Schnittstellenzeiger speichern. Es kann für die Kommunikation mit dem Windows-Explorer-Fenster verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
DLL Shell32.dll (Version 4.71 oder höher)

Weitere Informationen

IShellView2

IShellView2::GetView