SHGetPropertyStoreForWindow-Funktion (shellapi.h)

Artikel
08/26/2023

Ruft ein -Objekt ab, das die Auflistung von Eigenschaften eines bestimmten Fensters darstellt, sodass diese Eigenschaften abgefragt oder festgelegt werden können.

Syntax

SHSTDAPI SHGetPropertyStoreForWindow(
  [in]  HWND   hwnd,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das Fenster, dessen Eigenschaften abgerufen werden.

[in] riid

Typ: REFIID

Ein Verweis auf die IID des Eigenschaftsspeicherobjekts, das über ppv abgerufen werden soll. Dies ist in der Regel IID_IPropertyStore.

[out] ppv

Typ: void**

Wenn diese Funktion zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IPropertyStore.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Eine Anwendung kann diese Funktion verwenden, um Zugriff auf den Eigenschaftenspeicher eines Fensters zu erhalten, sodass sie eine explizite Anwendungsbenutzermodell-ID (AppUserModelID) in der System.AppUserModel.ID-Eigenschaft festlegen kann.

Die Eigenschaften eines Fensters müssen entfernt werden, bevor das Fenster geschlossen wird. Wenn dies nicht geschieht, werden die von diesen Eigenschaften verwendeten Ressourcen nicht an das System zurückgegeben. Eine Eigenschaft wird entfernt, indem Sie sie auf den PROPVARIANT-Typ VT_EMPTY festlegen.

Wenn IPropertyStore::SetValue für das über ppv abgerufene Objekt aufgerufen wird, werden die Eigenschaften und Werte sofort im Fenster gespeichert. Daher ist kein Aufruf von IPropertyStore::Commit erforderlich. Es tritt kein Fehler auf, wenn er aufgerufen wird, aber er hat keine Auswirkung.

Eine Anwendung legt AppUserModelIDs für einzelne Fenster fest, um die Taskleistengruppierung und den Inhalt der Sprungliste der Anwendung zu steuern. Für instance möchte eine Suiteanwendung möglicherweise eine andere Taskleistenschaltfläche für jedes ihrer Unterfeatures bereitstellen, wobei die Fenster, die sich auf dieses Unterfeature beziehen, unter dieser Schaltfläche gruppiert sind. Ohne AppUserModelIDs auf Fensterebene würden alle diese Fenster unter dem Standard-Prozess gruppiert.

Anwendungen sollten auch diesen Eigenschaftenspeicher verwenden, um diese Neustarteigenschaften festzulegen, damit das System die Anwendung in diesen Zustand zurückgeben kann.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 6.1 oder höher)

Weitere Informationen

Anwendungsbenutzermodell-IDs (AppUserModelIDs)

Freigeben über