Método IDesktopWallpaper::GetMonitorRECT (shobjidl_core.h)

Artigo
03/13/2024

Recupera o retângulo de exibição do monitor especificado.

Sintaxe

HRESULT GetMonitorRECT(
  [in]  LPCWSTR monitorID,
  [out] RECT    *displayRect
);

Parâmetros

[in] monitorID

A ID do monitor a ser consultado. Você pode obter esse valor por meio de GetMonitorDevicePathAt.

[out] displayRect

Um ponteiro para uma estrutura RECT que, quando esse método retorna com êxito, recebe o retângulo de exibição do monitor especificado por monitorID, em coordenadas de tela.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT , incluindo o seguinte.

Código de retorno	Descrição
S_FALSE	O monitor especificado por monitorID não está anexado ao sistema no momento.
E_POINTER	Um ponteiro NULL foi fornecido em displayRect.
E_INVALIDARG	A ID fornecida no monitorID não pode ser encontrada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

IDesktopWallpaper

Share via