DwmGetWindowAttribute-Funktion (dwmapi.h)

  • Artikel

Ruft den aktuellen Wert eines angegebenen DwM-Attributs (Desktop Window Manager) ab, das auf ein Fenster angewendet wird. Programmieranleitungen und Codebeispiele finden Sie unter Steuern des Renderns von Nicht-Client-Regionen.

Syntax

HRESULT DwmGetWindowAttribute(
  [in]  HWND  hwnd,
  [in]  DWORD dwAttribute,
  [out] PVOID pvAttribute,
  [in]  DWORD cbAttribute
);

Parameter

[in] hwnd

Das Handle für das Fenster, aus dem der Attributwert abgerufen werden soll.

[in] dwAttribute

Ein Flag, das beschreibt, welcher Wert abgerufen werden soll, angegeben als Wert der DWMWINDOWATTRIBUTE Enumeration. Dieser Parameter gibt an, welches Attribut abgerufen werden soll, und der pvAttribute Parameter verweist auf ein Objekt, in das der Attributwert abgerufen wird.

[out] pvAttribute

Ein Zeiger auf einen Wert, der, wenn diese Funktion erfolgreich zurückgegeben wird, den aktuellen Wert des Attributs empfängt. Der Typ des abgerufenen Werts hängt vom Wert des dwAttribute-Parameters ab. Das DWMWINDOWATTRIBUTE Enumerationsthema gibt in der Zeile für jedes Flag an, an welchen Werttyp Sie einen Zeiger im pvAttribute Parameter übergeben sollten.

[in] cbAttribute

Die Größe des Attributwerts, der über den pvAttribute Parameter empfangen wird. Der Typ des abgerufenen Werts und daher seine Größe in Byte hängt vom Wert des dwAttribute-Parameters ab.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- dwmapi.h
Library Dwmapi.lib
DLL- Dwmapi.dll

Siehe auch