# OSD_SetOEMWallpaper

> Changes the default Windows login wallpaper to one specified by the customer.

Source: https://docs.capaone.com/capainstaller/vb-scripting-library/osd-scripting-library/osd-functions-osd/osd-setoemwallpaper/  
Product: CapaInstaller — a separate CapaSystems product; do not apply this page to any other.

[VB Scripting Library](/capainstaller/vb-scripting-library/) > [OSD Scripting Library](/capainstaller/vb-scripting-library/osd-scripting-library/) > [OSD functions (OSD)](/capainstaller/vb-scripting-library/osd-scripting-library/osd-functions-osd/)

### OSD_SetOEMWallpaper()

Changes the default Windows login wallpaper to one specified by the customer.

### Arguments

No arguments provided.

### Return Type

Boolean, TRUE if function completed successfully.

### Wallpaper files

The wallpaper file to be used must allready exist on the disk in the following locations.

| OPERATING SYSTEM                                   | FILE NAME                 | LOCATION                                                |
|:---------------------------------------------------|:--------------------------|:--------------------------------------------------------|
| Windows 8, 8.1, 10, Windows Server 2012 / 2012 R2, | backgroundDefault.jpg     | \<target drive\>:\Windows\System32\oobe\info\backgrounds\ |
| Windows 7, Windows Server 2008 / 2008R2            | backgroundDefault.jpg     | \<target drive\>:\Windows\System32\oobe\info\backgrounds\ |
| Windows XP, Windows Server 2003 / 2003R2           | InstallationWallpaper.bmp | \<target drive\>:\Windows\System32\                       |

### Remarks

Typpically used in the PreBootScript.wsf  
The wallpaper files can be placed on the filesystem using the OSD extra files feature, which allows for adding aditional files to the filesystem once the image has been applied.

### Example

The following example specifies that a custom wallpaper should be used.

**VBScript**

```vb
Private Function IncludeScript(sScriptFile)
 '...
End Function

'Begin
  bStatus=True
  If bStatus Then bStatus=IncludeScript("customlib.cis")
  If bStatus Then bStatus=IncludeLibrary("Capalib.cin")
  If bStatus Then bStatus=IncludeLibrary("Osdlib.cin")
  If bStatus Then bStatus=Job_Start("WS","Script Name","1.0","ScriptName.log","INSTALL")
  If bStatus Then bStatus=OSD_Initialize()

  If bStatus Then bStatus=OSD_SetOEMWallpaper()

  Job_End(bStatus)
'End main

```

### See Also

[Scripting Guidelines](/capainstaller/vb-scripting-library/scripting-guidelines/) [Constants](/capainstaller/vb-scripting-library/addendum/constants/) [Package Property](/capainstaller/vb-scripting-library/addendum/package-property/) [Variables](/capainstaller/vb-scripting-library/addendum/variables/)
