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 |
|---|---|
|
Se pasó un identificador no válido a la función. |
|
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 |