IDesktopWallpaper::GetWallpaper 方法 (shobjidl_core.h)
获取当前桌面壁纸。
语法
HRESULT GetWallpaper(
[in] LPCWSTR monitorID,
[out] LPWSTR *wallpaper
);
参数
[in] monitorID
监视器的 ID。 可以通过 GetMonitorDevicePathAt 获取此值。
此值可以设置为 NULL。 在这种情况下,如果单个壁纸图像显示在系统的所有监视器上,该方法将成功返回。 如果此值设置为 NULL ,并且不同的监视器显示不同的壁纸或幻灯片放映正在运行,则该方法在 壁纸 参数中返回S_FALSE和空字符串。
[out] wallpaper
指向缓冲区的指针的地址,当此方法成功返回时,该缓冲区接收壁纸图像文件的路径。 请注意,此图像当前可能显示在系统的所有监视器上,而不仅仅是 在 monitorID 参数中指定的监视器上。
如果未显示壁纸图像或监视器显示纯色,则此字符串将为空。 如果 方法失败,字符串也将为空。
返回值
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
要求
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |