Поделиться через


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

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

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

Windows