# 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.