MsiCloseHandle, fonction (msi.h)

La fonction MsiCloseHandle ferme un handle d’installation ouvert.

Syntaxe

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

[in] hAny

Spécifie n’importe quel handle d’installation ouvert.

Valeur	Signification
ERROR_INVALID_HANDLE	Un handle non valide a été passé à la fonction.
ERROR_SUCCESS	La fonction a réussi.

MsiCloseHandle doit être appelé à partir du même thread que celui qui a demandé la création du handle.

Les handles d’approvisionnement de fonctions suivants doivent être fermés après utilisation en appelant MsiCloseHandle :

MsiCreateRecord MsiGetActiveDatabase MsiGetLastErrorRecord MsiOpenPackage MsiOpenProduct MsiOpenDatabase MsiDatabaseOpenView MsiViewViewGetColumnInfo MsiDatabaseGetPrimaryKeys MsiGetSummaryInformation MsiEnableUIPreview Notez que lors de l’écriture d’actions personnalisées, il est recommandé d’utiliser des variables de type PMSIHANDLE, car le programme d’installation ferme les objets PMSIHANDLE car ils sortent de l’étendue, alors que vous devez fermer les objets MSIHANDLE en appelant MsiCloseHandle.

Par exemple, si vous utilisez un code comme celui-ci :

MSIHANDLE hRec = MsiCreateRecord(3) ;

Remplacez-le par :

PMSIHANDLE hRec = MsiCreateRecord(3) ;

Condition requise	Valeur
Client minimal pris en charge	Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible	Windows
En-tête	msi.h
Bibliothèque	Msi.lib
DLL	Msi.dll