MsiViewGetColumnInfo 函数 (msiquery.h)

  • 项目

MsiViewGetColumnInfo 函数返回包含列名或定义的记录。 此函数返回应使用 MsiCloseHandle 关闭的句柄。

语法

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

参数

[in] hView

要从中获取列信息的视图的句柄。

[in] eColumnInfo

指定一个标志，指示所需的信息类型。 此参数须为下列值之一。

值 含义
MSICOLINFO_NAMES
 返回列名。
MSICOLINFO_TYPES
 返回定义。

[out] phRecord

指向用于接收列信息数据记录的句柄的指针。

返回值

请注意，在内存不足的情况下，此函数可能会引发STATUS_NO_MEMORY异常。

注解

MsiViewGetColumnInfo 返回的列说明采用列定义格式部分中所述的格式。 每个列由相应记录字段中的字符串描述。 定义字符串包含单个字母（表示数据类型）和列宽度（如果适用，则以字符为单位，否则以字节为单位）。 宽度为零表示宽度不受限制（例如，长文本字段和流）。 大写字母表示在列中允许使用 Null 值。

请注意，建议使用 PMSIHANDLE 类型的变量，因为安装程序在 PMSIHANDLE 对象超出范围时会关闭这些对象，而必须通过调用 MsiCloseHandle 关闭 MSIHANDLE 对象。 有关详细信息，请参阅 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 部分。

要求

要求 值
最低受支持的客户端 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer
目标平台 Windows
标头 msiquery.h
Library Msi.lib
DLL Msi.dll