Record Object

Windows Installer

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.

Methods

The Record object defines the following 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 defines the following properties.

Property Access type Description

DataSize

Read-only

Returns the size of the data for the designated field.

FieldCount

Read-only

Returns the number of fields in the record.

IntegerData

Read-only

Transfers 32-bit integer data in to or out of a specified field within the record.

IsNull

Read-only

Returns True if the indicated field is null and False if the field contains data.

StringData

Read-only

Transfers string data in to or out of a specified field within the record.

 

Requirements

VersionWindows Installer 5.0 on 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, Windows XP, and Windows 2000
DLLMsi.dll
IIDIID_IRecord is defined as 000C1093-0000-0000-C000-000000000046

See Also

CreateRecord Method
Windows Installer Scripting Examples

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.