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 Renderings von Nicht-Clientregionen.

Syntax

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

Parameter

hwnd

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

dwAttribute

Ein Flag, das den abzurufenden Wert beschreibt, der als Wert der DWMWINDOWATTRIBUTE-Enumeration angegeben wird. 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 bei erfolgreicher Rückgabe dieser Funktion den aktuellen Wert des Attributs empfängt. Der Typ des abgerufenen Werts hängt vom Wert des dwAttribute-Parameters ab. Das Thema DWMWINDOWATTRIBUTE-Enumeration gibt in der Zeile für jedes Flag an, auf welchen Werttyp Sie im pvAttribute-Parameter einen Zeiger übergeben sollten.

cbAttribute

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

Rückgabewert

Typ: HRESULT

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dwmapi.h
Bibliothek Dwmapi.lib
DLL Dwmapi.dll

Weitere Informationen