IExplorerBrowser::SetPropertyBag-Methode (shobjidl_core.h)

Artikel
03/02/2024

Legt den Namen des Eigenschaftenbehälters fest.

Syntax

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

Parameter

[in] pszPropertyBag

Typ: LPCWSTR

Ein Zeiger auf eine konstante Unicode-Zeichenfolge mit NULL-Termin, die den Namen des Eigenschaftenbehälters enthält. Anzeigen von Statusinformationen, die spezifisch für die Anwendung des Clients sind, wird unter diesem Namen gespeichert (beibehalten).

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

ExplorerBrowser kann die im Eigenschaftenbehälter gespeicherten Eigenschaften abrufen, indem die Funktion SHGetViewStatePropertyBag aufgerufen wird. ExplorerBrowser schreibt in diesen Eigenschaftenbehälter, der ebenfalls in der Registrierung gespeichert (persistent) ist. Persistenz tritt automatisch auf, wenn ExplorerBrowser die aktuelle Ansicht zerstört, eine Navigation beginnt oder zerstört wird. Nach einem dieser Ereignisse werden Informationen zum Ansichtszustand geschrieben, falls er vom Benutzer geändert wurde.

Wenn keine Eigenschaften gespeichert wurden, wird der Standardansichtszustand des ExplorerBrowsers verwendet. Der Standardansichtszustand ist der Ansichtszustand, den der Benutzer für einen bestimmten Speicherort festgelegt hat, oder wenn der Ansichtszustand für einen Speicherort nicht festgelegt wurde (nie vom Benutzer geändert), dann basiert der Standardansichtszustand auf der Vorlage für den Dateityp (z. B. Dokumente, Musik und Bilder) am Speicherort. Alle Explorer Fenster verwenden dieselbe Sequenz, um den Standardansichtszustand zu bestimmen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über