Partager via


MsiCloseHandle, fonction (msi.h)

La fonction MsiCloseHandle ferme un handle d’installation ouvert.

Syntaxe

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

Paramètres

[in] hAny

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

Valeur retournée

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

Remarques

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 :

MsiCreateRecordMsiGetActiveDatabaseMsiGetLastErrorRecordMsiOpenPackageMsiOpenProductMsiOpenDatabaseMsiDatabaseOpenView MsiViewViewGetColumnInfo MsiDatabaseGetPrimaryKeysMsiGetSummaryInformationMsiEnableUIPreview 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) ;

Configuration requise

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

Voir aussi

Gérer les fonctions de gestion