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 |
|
| IID |
IID_IRecord is defined as 000C1093-0000-0000-C000-000000000046 |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for