Funzione GetWindowDisplayAffinity (winuser.h)

Articolo
03/13/2024

Recupera l'impostazione di affinità di visualizzazione corrente, da qualsiasi processo, per una determinata finestra.

Sintassi

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

Parametri

[in] hWnd

Tipo: HWND

Handle nella finestra.

[out] pdwAffinity

Tipo: DWORD*

Puntatore a una variabile che riceve l'impostazione di affinità di visualizzazione. Per un elenco di impostazioni di affinità e dei relativi significati, vedere SetWindowDisplayAffinity .

Valore restituito

Tipo: BOOL

Questa funzione riesce solo quando la finestra è a livelli e Desktop Windows Manager sta componendo il desktop. Se questa funzione ha esito positivo, restituisce TRUE; in caso contrario, restituisce FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione e SetWindowDisplayAffinity sono progettate per supportare la funzionalità di protezione del contenuto della finestra univoca per Windows 7. Questa funzionalità consente alle applicazioni di proteggere il proprio contenuto della finestra sullo schermo da acquisire o copiare tramite un set specifico di funzionalità e API del sistema operativo pubblico. Tuttavia, funziona solo quando Desktop Window Manager (DWM) sta componendo il desktop.

È importante notare che a differenza di una funzionalità di sicurezza o di un'implementazione di Digital Rights Management (DRM), non vi è alcuna garanzia che l'uso di SetWindowDisplayAffinity e di GetWindowDisplayAffinity e altre funzioni necessarie, ad esempio DwmIsCompositionEnabled, proteggeranno rigorosamente il contenuto finestrato, come nel caso in cui qualcuno prende una fotografia dello schermo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-1 (introdotto in Windows 8.1)

Vedi anche

Informazioni concettuali

Windows

Condividi tramite