MsiViewGetColumnInfo function (msiquery.h)

The MsiViewGetColumnInfo function returns a record containing column names or definitions. This function returns a handle that should be closed using MsiCloseHandle.

Syntax

UINT MsiViewGetColumnInfo(
  [in]  MSIHANDLE  hView,
  [in]  MSICOLINFO eColumnInfo,
  [out] MSIHANDLE  *phRecord
);

Parameters

[in] hView

Handle to the view from which to obtain column information.

[in] eColumnInfo

Specifies a flag indicating what type of information is needed. This parameter must be one of the following values.

[out] phRecord

Pointer to a handle to receive the column information data record.

Return value

Note that in low memory situations, this function can raise a STATUS_NO_MEMORY exception.

Remarks

The column description returned by MsiViewGetColumnInfo is in the format described in the section: Column Definition Format. Each column is described by a string in the corresponding record field. The definition string consists of a single letter representing the data type followed by the width of the column (in characters when applicable, bytes otherwise). A width of zero designates an unbounded width (for example, long text fields and streams). An uppercase letter indicates that null values are allowed in the column.

Note that it is recommended to use variables of type PMSIHANDLE because the installer closes PMSIHANDLE objects as they go out of scope, whereas you must close MSIHANDLE objects by calling MsiCloseHandle. For more information see Use PMSIHANDLE instead of HANDLE section in the Windows Installer Best Practices.

Requirements