Funzione DwmGetWindowAttribute (dwmapi.h)

  • Articolo

Recupera il valore corrente di un attributo DWM (Desktop Window Manager) specificato applicato a una finestra. Per indicazioni sulla programmazione ed esempi di codice, vedere Controllo del rendering dell'area non client.

Sintassi

HRESULT DwmGetWindowAttribute(
  [in]  HWND  hwnd,
  [in]  DWORD dwAttribute,
  [out] PVOID pvAttribute,
  [in]  DWORD cbAttribute
);

Parametri

[in] hwnd

Handle della finestra da cui recuperare il valore dell'attributo.

[in] dwAttribute

Flag che descrive il valore da recuperare, specificato come valore dell'enumerazione DWMWINDOWATTRIBUTE . Questo parametro specifica l'attributo da recuperare e il parametro pvAttribute punta a un oggetto in cui viene recuperato il valore dell'attributo.

[out] pvAttribute

Puntatore a un valore che, quando la funzione restituisce correttamente, riceve il valore corrente dell'attributo. Il tipo del valore recuperato dipende dal valore del parametro dwAttribute. L'argomento di enumerazione DWMWINDOWATTRIBUTE indica, nella riga per ogni flag, il tipo di valore a cui passare un puntatore nel parametro pvAttribute.

[in] cbAttribute

Dimensioni, in byte, del valore dell'attributo ricevuto tramite il parametro pvAttribute . Il tipo del valore recuperato e pertanto la relativa dimensione in byte dipende dal valore del parametro dwAttribute.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di erroreHRESULT .

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2008 [solo app desktop]
piattaforma di destinazione Finestre
intestazione dwmapi.h
libreria Dwmapi.lib
dll Dwmapi.dll

Vedere anche