View a Transform
The VBScript file WiLstXfm.vbs is provided in the Windows SDK Components for Windows Installer Developers. This script sample can be used to view a transform file.
The sample demonstrates the use of:
- _TransformView table
- OpenDatabase method (Installer Object)
- LastErrorRecord method of the Installer object
- ApplyTransform method
- OpenView method
- Commit method of the Database object
- IsNull property
- StringData property of the Record object
Using this sample requires the CScript.exe version of Windows Script Host. To use CScript.exe to run this sample, type a command 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 WiLstXfm.vbs [path to reference database][option][path to transform to be viewed]
Specify the path to the reference Windows Installer database. Specify a list of paths to transform files that are being viewed. Each path in the list may by preceded by an optional numeric value. This value specifies a set of error conditions that are to be suppressed. You may add these values together to suppress multiple conditions. If no numeric option is specified, all the error conditions are suppressed. The arguments in this list are executed in the left-to-right order in which they appear on the command line.
| 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.