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 |
|---|---|
|
Un handle non valido è stato passato alla funzione. |
|
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 |