Partager via


Méthode IActiveDesktop ::GetWallpaper (shlobj_core.h)

Obtient le papier peint actuel.

Syntaxe

HRESULT GetWallpaper(
  [out] PWSTR pwszWallpaper,
        UINT  cchWallpaper,
        DWORD dwFlags
);

Paramètres

[out] pwszWallpaper

Type : PWSTR

Lorsque cette méthode est retournée, contient un pointeur vers une mémoire tampon Unicode terminée par null qui contient le nom de fichier du papier peint.

cchWallpaper

Type : UINT

Taille de la chaîne pwszWallpaper , en caractères.

dwFlags

Type : DWORD

Type de papier peint à obtenir. Une des valeurs suivantes.

AD_GETWP_BMP (0x00000000)

Obtenir une bitmap.

AD_GETWP_IMAGE (0x00000001)

Obtenir une image.

AD_GETWP_LAST_APPLIED (0x00000002)

Obtenez le type de papier peint qui a été appliqué pour la dernière fois.

Valeur retournée

Type : HRESULT

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

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h
DLL Shell32.dll (version 4.71 ou ultérieure)