GetWindowDisplayAffinity 函数 (winuser.h)

从任何进程中检索给定窗口的当前显示相关性设置。

语法

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

参数

[in] hWnd

类型：HWND

窗口的句柄。

[out] pdwAffinity

类型： DWORD*

指向接收显示相关性设置的变量的指针。 有关相关性设置及其含义的列表，请参阅 SetWindowDisplayAffinity 。

返回值

类型： BOOL

仅当窗口分层且桌面 Windows 管理器正在组合桌面时，此函数才会成功。 如果此函数成功，则返回 TRUE;否则，它将返回 FALSE。 要获得更多的错误信息，请调用 GetLastError。

注解

此函数和 SetWindowDisplayAffinity 旨在支持 Windows 7 特有的窗口内容保护功能。 此功能使应用程序能够保护其自己的屏幕窗口内容不被通过一组特定的公共操作系统功能和 API 捕获或复制。 但是，仅当桌面窗口管理器 (DWM) 组合桌面时，它才有效。

需要注意的是，与安全功能或数字版权管理 (DRM) 实现不同，无法保证使用 SetWindowDisplayAffinity 和 GetWindowDisplayAffinity 以及其他必要功能（如 DwmIsCompositionEnabled）将严格保护窗口内容，就像有人拍摄屏幕照片一样。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8.1) 中引入的 ext-ms-win-ntuser-window-l1-1-1 (

请参阅

概念性

Windows