IActiveDesktop::SetWallpaper method (shlobj_core.h)

Sets the wallpaper for the Active Desktop.

Syntax

HRESULT SetWallpaper(
  [in] PCWSTR pwszWallpaper,
       DWORD  dwReserved
);

Parameters

[in] pwszWallpaper

Type: PCWSTR

A string value containing the file name of the wallpaper to be set.

dwReserved

Type: DWORD

Reserved. Must be set to zero.

Return value

Type: HRESULT

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

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj_core.h
DLL Shell32.dll (version 4.71 or later)

See also

IActiveDesktop