# GetWallpaper

int GetWallpaper (int *tiled, char bitmapFile[]);

## Purpose

This function gets the current Windows desktop wallpaper. This is useful if your application is going to change the wallpaper, as it must be able to restore the original settings when it completes.

## Parameters

Output
Name | Type | Description
tiled | integer * | Returns a boolean indicating whether or not the walpaper is tiled. If this value is 0, then the wallpaper is centered on the desktop.
bitmapFile | char [] | A buffer into which the function will copy the full NULL–terminated pathname of the desktop wallpaper file (a bitmap). This buffer must be at least MAX_PATHNAME_LEN bytes. If no wallpaper is currently configured, the function will return an empty string.

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