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 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
DLL Shell32.dll (4.71 或更高版本)