Using the Summary Information Stream
This section describes which functions in the Windows Installer API can call the summary information stream properties. For more information on the summary information stream and how it works with databases, see About the Summary Information Stream.
- It is important to remember that the installer contains different types of databases, and some properties of the summary information stream have different meanings with different databases. For more information, see Summary Property Descriptions.
- When a database is opened as the output of another database, the summary information stream of the output database is actually a read-only mirror of the original database and thus cannot be changed. Additionally, it will not be persisted with the database. To create or modify the summary information for the output database it must be closed and re-opened.
The following steps describe how to use the summary information stream functions:
To use the summary information stream properties
- Obtain a handle to the database containing the summary information stream by calling the MsiGetSummaryInformation function.
- Call the MsiSummaryInfoGetPropertyCount function to obtain the number of existing properties.
- Call the MsiSummaryInfoGetProperty function to view a single summary information property.
- Call the MsiSummaryInfoSetProperty function to set a single property
- Call the MsiSummaryInfoPersist function to save the summary information property.
- Call the MsiCreateTransformSummaryInfo function to create the summary information for an existing transform.
Orca.exe and Msiinfo.exe are tools that can be used to edit or display the summary information stream of a database. These tools are only available in the Windows SDK Components for Windows Installer Developers.
The summary information stream can also be accessed using the following methods and properties of the Windows Installer Automation Interface.
The VBScript file WiSumInf.vbs is provided in the Windows SDK Components for Windows Installer Developers. This sample script can be used to manage the summary information stream of a Windows Installer package. For more information about WiSumInf.vbs, see Manage Summary Information.