IDesktopWallpaper::SetWallpaper method (shobjidl_core.h)

Sets the desktop wallpaper.

Syntax

HRESULT SetWallpaper(
  [in] LPCWSTR monitorID,
  [in] LPCWSTR wallpaper
);

[in] monitorID

The ID of the monitor. This value can be obtained through GetMonitorDevicePathAt. Set this value to NULL to set the wallpaper image on all monitors.

[in] wallpaper

The full path of the wallpaper image file.

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)