IDesktopWallpaper::GetMonitorRECT-Methode (shobjidl_core.h)

  • Artikel

Ruft das Anzeigerechteck des angegebenen Monitors ab.

Syntax

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

Parameter

[in] monitorID

Die ID des abzufragenden Monitors. Sie können diesen Wert über GetMonitorDevicePathAt abrufen.

[out] displayRect

Ein Zeiger auf eine RECT-Struktur , die nach erfolgreicher Rückgabe dieser Methode das Anzeigerechteck des Monitors empfängt, der von monitorID in Bildschirmkoordinaten angegeben wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben, einschließlich des folgenden.

Rückgabecode Beschreibung
S_FALSE
 Der von monitorID angegebene Monitor ist derzeit nicht an das System angefügt.
E_POINTER
 In displayRect wurde ein NULL-Zeiger bereitgestellt.
E_INVALIDARG
 Die in monitorID angegebene ID wurde nicht gefunden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IDesktopWallpaper