Méthode IDesktopWallpaper::GetWallpaper (shobjidl_core.h)

Obtient le papier peint du bureau actuel.

Syntaxe

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

Paramètres

[in] monitorID

ID du moniteur. Cette valeur peut être obtenue via GetMonitorDevicePathAt.

Cette valeur peut être définie sur NULL. Dans ce cas, si une seule image de papier peint s’affiche sur tous les moniteurs du système, la méthode retourne correctement. Si cette valeur est définie sur NULL et que différents moniteurs affichent différents fonds d’écran ou qu’un diaporama est en cours d’exécution, la méthode retourne S_FALSE et une chaîne vide dans le paramètre wallpaper .

[out] wallpaper

Adresse d’un pointeur vers une mémoire tampon qui, lorsque cette méthode retourne correctement, reçoit le chemin d’accès au fichier image de papier peint. Notez que cette image peut actuellement être affichée sur tous les moniteurs du système, et pas seulement sur le moniteur spécifié dans le paramètre monitorID .

Cette chaîne sera vide si aucune image de papier peint n’est affichée ou si un moniteur affiche une couleur unie. La chaîne sera également vide si la méthode échoue.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Voir aussi

IDesktopWallpaper

IDesktopWallpaper::SetWallpaper