Condividi tramite


Funzione MsiCloseHandle (msi.h)

La funzione MsiCloseHandle chiude un handle di installazione aperto.

Sintassi

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

Parametri

[in] hAny

Specifica qualsiasi handle di installazione aperto.

Valore restituito

Valore Significato
ERROR_INVALID_HANDLE
Un handle non valido è stato passato alla funzione.
ERROR_SUCCESS
Funzione completata.
 
 

Commenti

MsiCloseHandle deve essere chiamato dallo stesso thread che ha richiesto la creazione dell'handle.

Le funzioni seguenti forniscono handle che devono essere chiusi dopo l'uso chiamando MsiCloseHandle:

MsiCreateRecordMsiGetActiveDatabaseMsiGetLastErrorRecordMsiOpenPackage MsiOpenProductMsiOpenDatabaseMsiDatabaseOpenViewMsiViewFetchMsiViewGetColumnInfoMsiDatabaseGetPrimaryKeysMsiGetSummaryInformationMsiEnableUIPreview Nota che durante la scrittura di azioni personalizzate, è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE mentre escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle.

Ad esempio, se si usa codice simile al seguente:

MSIHANDLE hRec = MsiCreateRecord(3);

Sostituirlo con:

PMSIHANDLE hRec = MsiCreateRecord(3);

Requisiti

Requisito Valore
Client minimo supportato Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows Richiesto da una versione di Windows Installer, vedere i requisiti di Windows Installer Run-Time.
Piattaforma di destinazione Windows
Intestazione msi.h
Libreria Msi.lib
DLL Msi.dll

Vedi anche

Gestire le funzioni di gestione