Record object

The Record object is a container for holding and transferring a variable number of values. Fields within the record are numerically indexed and can contain strings, integers, objects, and null values. Fields beyond the allocated record size are treated as having permanently null values. Field number 0 is reserved.

Members

The Record object has these types of members:

Methods

The Record object has these methods.

Method Description
ClearData Clears the data in all fields, setting them to null.
FormatText Formats fields according to the template in field 0.
ReadStream Reads a specified number of bytes from a record field holding stream data.
SetStream Copies the content of the specified file into the designated record field as stream data.

 

Properties

The Record object has these properties.

Property Access type Description
DataSize
Returns the size of the data for the designated field.
FieldCount
Returns the number of fields in the record.
IntegerData
Read/write
Transfers 32-bit integer data in to or out of a specified field within the record.
IsNull
Returns True if the indicated field is null and False if the field contains data.
StringData
Read/write
Transfers string data in to or out of a specified field within the record.

 

Requirements

Requirement Value
Version
Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP
DLL
Msi.dll
IID
IID_IRecord is defined as 000C1093-0000-0000-C000-000000000046

See also

CreateRecord Method

Windows Installer Scripting Examples