Функция GetWindowDisplayAffinity (winuser.h)

Статья
08/27/2023

Извлекает текущий параметр сопоставления отображения из любого процесса для заданного окна.

Синтаксис

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
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-1 (появилось в Windows 8.1)

См. также раздел

Основные понятия

Windows