Using the Summary Information Stream

[This is preliminary documentation and subject to change.]

This section describes which functions in the Microsoft® 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.

Note  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.

Note  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

1. Obtain a handle to the summary information stream database by calling the MsiGetSummaryInformation function.
2. Call the MsiSummaryInfoGetPropertyCount function to obtain the number of existing properties.
3. Call the MsiSummaryInfoGetProperty function to view a single summary information property.
4. Call the MsiSummaryInfoSetProperty function to set a single property
5. Call the MsiSummaryInfoPersist function to save the summary information property.