Compartilhar via


Função DwmGetWindowAttribute (dwmapi.h)

Recupera o valor atual de um atributo DWM (Gerenciador de Janelas da Área de Trabalho) especificado aplicado a uma janela. Para obter diretrizes de programação e exemplos de código, consulte Controlandode renderização de região não cliente.

Sintaxe

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

Parâmetros

[in] hwnd

O identificador para a janela da qual o valor do atributo deve ser recuperado.

[in] dwAttribute

Um sinalizador que descreve qual valor recuperar, especificado como um valor da enumeração DWMWINDOWATTRIBUTE . Esse parâmetro especifica qual atributo recuperar e o parâmetro pvAttribute aponta para um objeto no qual o valor do atributo é recuperado.

[out] pvAttribute

Um ponteiro para um valor que, quando essa função retorna com êxito, recebe o valor atual do atributo. O tipo do valor recuperado depende do valor do parâmetro dwAttribute . O tópico de enumeração DWMWINDOWATTRIBUTE indica, na linha de cada sinalizador, para qual tipo de valor você deve passar um ponteiro no parâmetro pvAttribute .

[in] cbAttribute

O tamanho, em bytes, do valor do atributo que está sendo recebido por meio do parâmetro pvAttribute . O tipo do valor recuperado e, portanto, seu tamanho em bytes, depende do valor do parâmetro dwAttribute.

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um de código de erro HRESULT.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho dwmapi.h
biblioteca Dwmapi.lib
de DLL Dwmapi.dll

Consulte também