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 |
|---|---|
|
Un handle non valide a été passé à la fonction. |
|
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 |