Fungsi GetWindowDisplayAffinity (winuser.h)

Mengambil pengaturan afinitas tampilan saat ini, dari proses apa pun, untuk jendela tertentu.

Sintaks

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

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela.

[out] pdwAffinity

Jenis: DWORD*

Penunjuk ke variabel yang menerima pengaturan afinitas tampilan. Lihat SetWindowDisplayAffinity untuk daftar pengaturan afinitas dan maknanya.

Nilai kembali

Jenis: BOOL

Fungsi ini hanya berhasil ketika jendela berlapis dan Desktop Windows Manager sedang menyusun desktop. Jika fungsi ini berhasil, fungsi ini mengembalikan TRUE; jika tidak, ia mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ini dan SetWindowDisplayAffinity dirancang untuk mendukung fitur perlindungan konten jendela yang unik untuk Windows 7. Fitur ini memungkinkan aplikasi untuk melindungi konten jendela pada layar mereka sendiri agar tidak ditangkap atau disalin melalui serangkaian fitur dan API sistem operasi publik tertentu. Namun, ini hanya berfungsi ketika Desktop Window Manager (DWM) menyusun desktop.

Penting untuk dicatat bahwa tidak seperti fitur keamanan atau implementasi Manajemen Hak Digital (DRM), tidak ada jaminan bahwa menggunakan SetWindowDisplayAffinity dan GetWindowDisplayAffinity, dan fungsi lain yang diperlukan seperti DwmIsCompositionEnabled, akan melindungi konten berjendela secara ketat, seperti dalam kasus di mana seseorang mengambil foto layar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-1 (diperkenalkan dalam Windows 8.1)

Lihat juga

Konseptual

Windows