Compartir a través de

Función DwmSetWindowAttribute (dwmapi.h)

  • Artículo

Establece el valor de los atributos de representación que no son cliente de Desktop Window Manager (DWM) para una ventana. Para obtener instrucciones de programación y ejemplos de código, consulte Control de la representación de regiones que no son cliente.

Sintaxis

HRESULT DwmSetWindowAttribute(
  [in] HWND    hwnd,
  [in] DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
  [in] DWORD   cbAttribute
);

Parámetros

[in] hwnd

Identificador de la ventana para la que se va a establecer el valor del atributo.

[in] dwAttribute

Marca que describe qué valor se va a establecer, especificado como un valor de la enumeración DWMWINDOWATTRIBUTE. Este parámetro especifica qué atributo se va a establecer y el parámetro pvAttribute apunta a un objeto que contiene el valor del atributo.

[in] pvAttribute

Puntero a un objeto que contiene el valor de atributo que se va a establecer. El tipo del conjunto de valores depende del valor del parámetro dwAttribute. El tema de enumeración DWMWINDOWATTRIBUTE indica, en la fila de cada marca, qué tipo de valor debe pasar un puntero a en el parámetro pvAttribute.

[in] cbAttribute

Tamaño, en bytes, del valor del atributo que se establece a través del parámetro pvAttribute. El tipo del conjunto de valores y, por lo tanto, su tamaño en bytes, depende del valor del parámetro dwAttribute.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.

Si la composición del escritorio se ha deshabilitado (Windows 7 y versiones anteriores), esta función devuelve DWM_E_COMPOSITIONDISABLED.

Observaciones

No es válido llamar a esta función con el parámetro dwAttribute establecido en DWMWA_NCRENDERING_ENABLED. Para habilitar o deshabilitar la representación no cliente, debe usar el atributo DWMWA_NCRENDERING_POLICY y establecer el valor deseado. Para obtener más información y un ejemplo de código, consulte Control de la representación de regiones que no son cliente.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de dwmapi.h
biblioteca de Dwmapi.lib
DLL de Dwmapi.dll; Uxtheme.dll

Consulte también