MsiCloseHandle 函数 (msi.h)
MsiCloseHandle 函数关闭打开的安装句柄。
语法
UINT MsiCloseHandle(
[in] MSIHANDLE hAny
);
参数
[in] hAny
指定任何打开的安装句柄。
返回值
| 值 | 含义 |
|---|---|
|
传递给函数的句柄无效。 |
|
函数成功。 |
注解
必须从请求创建句柄的同一线程调用 MsiCloseHandle。
以下函数提供应在使用后通过调用 MsiCloseHandle 关闭的句柄：
MsiCreateRecordMsiGetActiveDatabaseMsiGetLastErrorRecordMsiOpenPackageMsiOpenProductMsiOpenDatabaseMsiDatabaseOpenViewMsiViewFetchMsiViewGetColumnInfoMsiDatabaseGetPrimaryKeysMsiGetSummaryInformationMsiEnableUIPreview 请注意，在编写自定义操作时，建议使用 PMSIHANDLE 类型的变量，因为安装程序会关闭 PMSIHANDLE 对象因为它们超出范围，而必须通过调用 MsiCloseHandle 关闭 MSIHANDLE 对象。
例如，如果你使用如下所示的代码：
MSIHANDLE hRec = MsiCreateRecord (3) ;
请将其更改为：
PMSIHANDLE hRec = MsiCreateRecord (3) ;
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 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 Installer 版本所需的最低 Windows Service Pack，请参阅 Windows Installer 运行时要求。 |
| 目标平台 | Windows |
| 标头 | msi.h |
| Library | Msi.lib |
| DLL | Msi.dll |