msiOpenDatabaseW 函数 (msiquery.h)
MsiOpenDatabase 函数会打开用于数据访问的数据库文件。 此函数返回应使用 MsiCloseHandle 关闭的句柄。
语法
UINT MsiOpenDatabaseW(
[in] LPCWSTR szDatabasePath,
[in] LPCWSTR szPersist,
[out] MSIHANDLE *phDatabase
);
参数
[in] szDatabasePath
指定数据库文件的完整路径或相对路径。
[in] szPersist
接收文件或持久性模式的完整路径。 可以使用 szPersist 参数将持久输出定向到新文件或指定以下预定义持久性模式之一。
[out] phDatabase
指向返回的数据库句柄位置的指针。
返回值
MsiOpenDatabase 函数返回以下值:
注解
若要对数据库进行更改并保存,请先在事务 (MSIDBOPEN_TRANSACT) 中打开数据库,创建 (MSIDBOPEN_CREATE 或MSIDBOPEN_CREATEDIRECT) ,或直接 (MSIDBOPEN_DIRECT) 模式。 进行更改后,始终在关闭数据库句柄之前调用 MsiDatabaseCommit 。 MsiDatabaseCommit 会刷新所有缓冲区。
在关闭数据库句柄之前,请始终在以直接模式 (MSIDBOPEN_DIRECT 或MSIDBOPEN_CREATEDIRECT) 打开的数据库上调用 MsiDatabaseCommit 。 否则,可能会损坏数据库。
由于 MsiOpenDatabase 会启动数据库访问,因此它不能与正在运行的安装一起使用。
请注意,建议使用 PMSIHANDLE 类型的变量,因为安装程序在 PMSIHANDLE 对象超出范围时会关闭这些对象,而必须通过调用 MsiCloseHandle 关闭 MSIHANDLE 对象。 有关详细信息,请参阅 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 部分。
注意
msiquery.h 标头将 MsiOpenDatabase 定义为别名,该别名根据 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 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈