Freigeben über

IActiveDesktop::GetWallpaper-Methode (shlobj_core.h)

  • Artikel

Ruft das aktuelle Hintergrundbild ab.

Syntax

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

Parameter

[out] pwszWallpaper

Typ: PWSTR

Wenn diese Methode zurückgibt, enthält einen Zeiger auf einen Unicode-Puffer mit Null-Beendigung, der den Dateinamen des Hintergrundbilds enthält.

cchWallpaper

Typ: UINT

Die Größe der pwszWallpaper-Zeichenfolge in Zeichen.

dwFlags

Art: DWORD

Der Typ des zu erhaltenden Hintergrundbilds. Einer der folgenden Werte.

AD_GETWP_BMP (0x00000000)

Ruft eine Bitmap ab.

AD_GETWP_IMAGE (0x00000001)

Rufen Sie ein Bild ab.

AD_GETWP_LAST_APPLIED (0x00000002)

Rufen Sie den Hintergrundbildtyp ab, der zuletzt angewendet wurde.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h
DLL Shell32.dll (Version 4.71 oder höher)