SetWallpaper

int SetWallpaper (int displayStyle, const char bitmapFile[]);

Purpose

This function sets the current Windows desktop wallpaper.

Parameters

Input
Name Type Description
displayStyle integer The orientation of the bitmap on the desktop window.
bitmapFile const char [] The pathname of the bitmap (*.BMP) file to set as the Windows desktop wallpaper. If you do not want any wallpaper, pass an empty string.

Example:

"C:\\WinNT\\winnt.bmp" or ""

Return Value

Name Type Description
status integer The status code that the function returns.

0 indicates success.

A negative value indicates an error.

This function may return a Programmer's Toolbox or UI Library error code. Call GetGeneralErrorString to obtain a text description of the error.