Apply a Transform
The VBScript file WiUseXfm.vbs is provided in the Windows SDK Components for Windows Installer Developers. This sample shows how script can be used to apply a transform to a Windows Installer database.
The sample demonstrates the use of
- OpenDatabase method (Installer Object)
- LastErrorRecord method of the Installer object
- ApplyTransform method
- Commit method of the Database object
You'll require the CScript.exe or WScript.exe version of Windows Script Host to use this sample. To use CScript.exe to run this sample, type a command line at the command prompt using the following syntax. Help is displayed if the first argument is /? or if too few arguments are specified. To redirect the output to a file, end the command line with VBS > [path to file]. The sample returns a value of 0 for success, 1 if help is invoked, and 2 if the script fails.
cscript WiUseXfm.vbs [path to original database][path to transform file][options]
Specify the path to the Windows Installer database. Specify the path to the transform file. If the path to the transform file is omitted, the two databases are only compared. The third argument is an optional numeric value that specifies a set of error conditions that are to be suppressed. Add these values together to suppress multiple conditions.
| Value | Error condition to suppress |
|---|---|
| 1 | Adding a row that already exists. |
| 2 | Deleting a row that does not exist. |
| 4 | Adding a table that already exists. |
| 8 | Deleting a table that does not exist. |
| 16 | Updating a row that does not exist. |
| 256 | Mismatch of database and transform codepages. |
For additional scripting examples, see Windows Installer Scripting Examples. For sample utilities that do not require Windows Script Host, see Windows Installer Development Tools.