The MsiRecordSetString function copies a string into the designated field.

Syntax

UINT MsiRecordSetString(
  __in  MSIHANDLE hRecord,
  __in  unsigned int iField,
  __in  LPCTSTR szValue
);

Parameters

hRecord [in]

Handle to the record.

iField [in]

Specifies the field of the record to set.

szValue [in]

Specifies the string value of the field.

Return Value

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_PARAMETER

An invalid parameter was passed to the function.

ERROR_SUCCESS

The function succeeded.

Remarks

In the MsiRecordSetString function, a null string pointer and an empty string both set the field to null. Attempting to store a value in a nonexistent field causes an error.

To set a record string field to null, set szValue to either a null string or an empty string.

Requirements

See Also

Record Processing Functions

Send comments about this topic to Microsoft

Build date: 11/12/2009