Compartir a través de


Función MsiCloseHandle (msi.h)

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

Sintaxis

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

Parámetros

[in] hAny

Especifica cualquier identificador de instalación abierto.

Valor devuelto

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.
 
 

Comentarios

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:

MsiCreateRecordMsiGetActiveDatabaseMsiGetLastErrorRecordMsiOpenPackageMsiOpenProductMsiOpenDatabaseMsiDatabaseOpenViewMsiViewFetchMsiViewGetColumnInfoMsiDatabaseGetPrimaryKeysMsiGetSummaryInformationMsiEnableUIPreview 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);

Requisitos

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

Consulte también

Funciones de administración del controlador