Función MsiCloseHandle (msi.h)

La función MsiCloseHandle cierra un identificador de instalación abierto.

Sintaxis

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

[in] hAny

Especifica cualquier identificador de instalación abierto.

Valor	Significado
ERROR_INVALID_HANDLE	Se pasó un identificador no válido a la función.
ERROR_SUCCESS	La función se ha realizado correctamente.

Se debe llamar a MsiCloseHandle desde el mismo subproceso que solicitó la creación del identificador.

Las siguientes funciones proporcionan identificadores que deben cerrarse después de usarlos mediante una llamada a MsiCloseHandle:

MsiCreateRecord MsiGetActiveDatabase MsiGetLastErrorRecord MsiOpenPackage MsiOpenProduct MsiOpenDatabase MsiDatabaseOpenView MsiViewFetch MsiViewGetColumnInfo MsiDatabaseGetPrimaryKeys MsiGetSummaryInformation MsiEnableUIPreview Tenga en cuenta que, al escribir acciones personalizadas, se recomienda usar variables de tipo PMSIHANDLE porque el instalador cierra objetos PMSIHANDLE a medida que salen del ámbito, mientras que debe cerrar objetos MSIHANDLE mediante una llamada a MsiCloseHandle.

Por ejemplo, si usa código como este:

MSIHANDLE hRec = MsiCreateRecord(3);

Cámbielo por esto:

PMSIHANDLE hRec = MsiCreateRecord(3);

Requisito	Value
Cliente mínimo compatible	Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP. Consulte Windows Installer para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino	Windows
Encabezado	msi.h
Library	Msi.lib
Archivo DLL	Msi.dll