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)

另请参阅

IDesktopWallpaper

IDesktopWallpaper::SetWallpaper