Funzione MsiCloseHandle (msi.h)

La funzione MsiCloseHandle chiude un handle di installazione aperto.

Sintassi

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

[in] hAny

Specifica qualsiasi handle di installazione aperto.

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

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:

MsiCreateRecord MsiGetActiveDatabase MsiGetLastErrorRecord MsiOpenPackage MsiOpenProduct MsiOpenDatabase MsiDatabaseOpenView MsiViewFetch MsiViewGetColumnInfo MsiDatabaseGetPrimaryKeys MsiGetSummaryInformation MsiEnableUIPreview 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);

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