IActiveDesktop：：GetWallpaper 方法 (shlobj_core.h)

  • 發行項

取得目前的桌布。

語法

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

參數

[out] pwszWallpaper

類型： PWSTR

當這個方法傳回時，會包含以 Null 終止的 Unicode 緩衝區指標，其中包含背景圖案的檔名。

cchWallpaper

類型： UINT

pwszWallpaper 字串的大小，以字元為單位。

dwFlags

類型： DWORD

要取得的桌布類型。 下列其中一個值。

AD_GETWP_BMP (0x00000000)

取得位圖。

AD_GETWP_IMAGE (0x00000001)

取得影像。

AD_GETWP_LAST_APPLIED (0x00000002)

取得上次套用的桌布類型。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h
Dll Shell32.dll (4.71 版或更新版本)