MsiRecordIsNull

[This is preliminary documentation and subject to change.]

The MsiRecordIsNull function reports whether a record field is NULL.

BOOL MsiRecordIsNull(
  MSIHANDLE hRecord,    // record handle
  unsigned int iField   // field of record
);
 

Parameters

hRecord

Handle to the record.

iField

Specifies the field to check.

Return Values

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

FALSE

The function succeeded and the field is not null.

TRUE

The function succeeded and the field is null.

Remarks

For the MsiRecordIsNull function, an integer value specifying a non-existent field of the record returns TRUE.

The iField parameter is based on 1.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msiquery.h.
  Import Library: Use msi.lib.

See Also

Database Access Reference, Record Processing Functions