MsiCloseHandle-Funktion (msi.h)
Die MsiCloseHandle-Funktion schließt ein geöffnetes Installationshandle.
Syntax
UINT MsiCloseHandle(
[in] MSIHANDLE hAny
);
Parameter
[in] hAny
Gibt alle geöffneten Installationshandle an.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Ein ungültiges Handle wurde an die Funktion übergeben. |
|
Die Funktion wurde erfolgreich ausgeführt. |
Hinweise
MsiCloseHandle muss aus demselben Thread aufgerufen werden, der die Erstellung des Handles angefordert hat.
Die folgenden Funktionen stellen Handles bereit, die nach der Verwendung durch Aufrufen von MsiCloseHandle geschlossen werden sollten:
MsiCreateRecordMsiGetActiveDatabaseMsiGetLastErrorRecordMsiOpenPackageMsiOpenProductMsiOpenDatabaseOpenViewMsiViewFetchMsiViewGetColumnInfoMsiDatabaseGetPrimaryKeysMsiGetSummaryInformationMsiEnableUIPreview Hinweis: Beim Schreiben benutzerdefinierter Aktionen wird empfohlen, Variablen vom Typ PMSIHANDLE zu verwenden, da das Installationsprogramm PMSIHANDLE-Objekte schließt wenn sie außerhalb des Bereichs liegen, während Sie MSIHANDLE-Objekte schließen müssen, indem Sie MsiCloseHandle aufrufen.
Wenn Sie zum Beispiel einen Code wie diesen verwenden:
MSIHANDLE hRec = MsiCreateRecord(3);
Ändern Sie ihn in:
PMSIHANDLE hRec = MsiCreateRecord(3);
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen. |
| Zielplattform | Windows |
| Kopfzeile | msi.h |
| Bibliothek | Msi.lib |
| DLL | Msi.dll |