Metodo IDesktopWallpaper::GetWallpaper (shobjidl_core.h)

Articolo
08/26/2023

Ottiene lo sfondo desktop corrente.

Sintassi

HRESULT GetWallpaper(
  [in]  LPCWSTR monitorID,
  [out] LPWSTR  *wallpaper
);

Parametri

[in] monitorID

ID del monitoraggio. Questo valore può essere ottenuto tramite GetMonitorDevicePathAt.

Questo valore può essere impostato su NULL. In tal caso, se viene visualizzata un'unica immagine dello sfondo su tutti i monitor del sistema, il metodo restituisce correttamente. Se questo valore è impostato su NULL e monitor diversi vengono visualizzati sfondi diversi o una presentazione in esecuzione, il metodo restituisce S_FALSE e una stringa vuota nel parametro dello sfondo .

[out] wallpaper

L'indirizzo di un puntatore a un buffer che, quando questo metodo restituisce correttamente, riceve il percorso del file di immagine dello sfondo. Si noti che questa immagine può essere attualmente visualizzata in tutti i monitor del sistema, non solo il monitoraggio specificato nel parametro monitorID .

Questa stringa sarà vuota se non viene visualizzata alcuna immagine dello sfondo o se un monitor visualizza un colore a tinta unita. La stringa sarà vuota anche se il metodo ha esito negativo.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

IDesktopWallpaper

IDesktopWallpaper::SetWallpaper

Condividi tramite