MsiDatabaseGetPrimaryKeysA 函数 (msiquery.h)
MsiDatabaseGetPrimaryKeys 函数返回一条记录,其中包含指定表的所有主键列的名称。 此函数返回应使用 MsiCloseHandle 关闭的句柄。
语法
UINT MsiDatabaseGetPrimaryKeysA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szTableName,
[out] MSIHANDLE *phRecord
);
参数
[in] hDatabase
数据库的句柄。 请参阅获取数据库句柄。
[in] szTableName
指定要从中获取主键名称的表的名称。
[out] phRecord
指向保存主键名称的记录句柄的指针。
返回值
此函数返回 UINT。
注解
返回记录的字段计数是 MsiDatabaseGetPrimaryKeys 函数返回的主键列的计数。 返回的记录包含字段 (0) 中的表名,以及构成后续字段中主键名称的列名。 这些主键名称对应于字段的列号。
此函数不能与 _Tables 表 或 _Columns表一起使用。
请注意,建议使用 PMSIHANDLE 类型的变量,因为安装程序在 PMSIHANDLE 对象超出范围时会关闭这些对象,而必须通过调用 MsiCloseHandle 关闭 MSIHANDLE 对象。 有关详细信息,请参阅 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 部分。
注意
msiquery.h 标头将 MsiDatabaseGetPrimaryKeys 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 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 |