Manage Substorages
The VBScript file WiSubStg.vbs is provided in the Windows SDK Components for Windows Installer Developers. This sample shows how script can be used to manage substorages in a Windows Installer database. A transform can be added to an existing Windows Installer database as a substorage.
The sample demonstrates the use of:
- _Storages table
- OpenDatabase method (Installer Object)
- CreateRecord method
- LastErrorRecord method of the Installer object
- OpenView method
- Commit method of the Database object
- Fetch method
- Modify method
- Execute method of the View object
- StringData property
- SetStream method of the Record 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 WiSubStg.vbs [path to database][path to file][options][substorage name]
Specify the path to the Windows Installer database to add or remove substorage. Specify a path to the transform or database file that is being added as substorage. To list the substorages in the Windows Installer database, omit the path to this file. You may specify an optional substorage name, if this is omitted the substorage name defaults to the file name.
The following option may be specified.
| Option | Description |
|---|---|
| no option specified | Add a substorage to the Windows Installer database. |
| /d | Remove a substorage. This option flag must be followed by the name of the substorage to be removed. |
For additional scripting examples, see Windows Installer Scripting Examples. For sample utilities that do not require Windows Script Host, see Windows Installer Development Tools.
Note that A Localization Example demonstrates Embedding Customization Transforms as Substorage.