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
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (inclure Shobjidl.h) |