Working with Records

[This is preliminary documentation and subject to change.]

The installer supplies functions that manipulate the records in an installation database. These functions can be used in conjunction with the functions described in Working with Queries to make actual changes in a database.

The following functions create or remove records.

To create a new record for a database, call the MsiCreateRecord function.
To clear data from a record, set each field to NULL by calling the MsiRecordClearData function.

The following functions fill specified fields of records:

To set a record to an integer, call the MsiRecordSetInteger function.
To set a record to a string, call the MsiRecordSetString function.
To insert an entire file into a stream field, call the MsiRecordSetStream function.

The following functions read values from specified fields of records:

To read an integer value from a field, call the MsiRecordGetInteger function.
To retrieve a string value, call the MsiRecordGetString function.
To obtain a stream, call the MsiRecordReadStream function.
To determine if a particular field of a record is NULL, call the MsiRecordIsNull function.

The following functions are informational record functions:

To get the number of fields a record contains, call the MsiRecordGetFieldCount function.
To get the size of a field, call the MsiRecordDataSize function. The return value of MsiRecordDataSize is sensitive to the field type.