GetWindowDisplayAffinity-Funktion (winuser.h)

Artikel
03/04/2024

Ruft die aktuelle Einstellung für die Anzeigeaffinität aus einem beliebigen Prozess für ein bestimmtes Fenster ab.

Syntax

BOOL GetWindowDisplayAffinity(
  [in]  HWND  hWnd,
  [out] DWORD *pdwAffinity
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster.

[out] pdwAffinity

Typ: DWORD*

Ein Zeiger auf eine Variable, die die Einstellung für die Anzeigeaffinität empfängt. Eine Liste der Affinitätseinstellungen und deren Bedeutung finden Sie unter SetWindowDisplayAffinity .

Rückgabewert

Typ: BOOL

Diese Funktion ist nur erfolgreich, wenn das Fenster über eine Schicht verfügt und windows-Manager desktop den Desktop erstellt. Wenn diese Funktion erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion und SetWindowDisplayAffinity sind so konzipiert, dass sie das Feature zum Schutz von Fensterinhalten unterstützen, das für Windows 7 einzigartig ist. Mit diesem Feature können Anwendungen ihre eigenen Bildschirmfensterinhalte vor dem Erfassen oder Kopieren über einen bestimmten Satz von features und APIs des öffentlichen Betriebssystems schützen. Dies funktioniert jedoch nur, wenn der Desktopfenster-Manager (DWM) den Desktop erstellt.

Es ist wichtig zu beachten, dass im Gegensatz zu einem Sicherheitsfeature oder einer Implementierung von Digital Rights Management (DRM) keine Garantie dafür besteht, dass die Verwendung von SetWindowDisplayAffinity und GetWindowDisplayAffinity und anderen erforderlichen Funktionen wie DwmIsCompositionEnabled inhalte im Fenster streng schützen, wie bei einem Foto des Bildschirms.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-1 (eingeführt in Windows 8.1)

Siehe auch

Konzept

Windows

Freigeben über