MsiCloseHandle 函数 (msi.h)

MsiCloseHandle 函数关闭打开的安装句柄。

语法

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

[in] hAny

指定任何打开的安装句柄。

值	含义
ERROR_INVALID_HANDLE	传递给函数的句柄无效。
ERROR_SUCCESS	函数成功。

必须从请求创建句柄的同一线程调用 MsiCloseHandle。

以下函数提供应在使用后通过调用 MsiCloseHandle 关闭的句柄：

MsiCreateRecord MsiGetActiveDatabase MsiGetLastErrorRecord MsiOpenPackage MsiOpenProduct MsiOpenDatabase MsiDatabaseOpenView MsiViewFetch MsiViewGetColumnInfo MsiDatabaseGetPrimaryKeys MsiGetSummaryInformation MsiEnableUIPreview 请注意，在编写自定义操作时，建议使用 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