Metodo IDesktopWallpaper::GetWallpaper (shobjidl_core.h)
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) |