MsiCloseHandle-Funktion (msi.h)

  • Artikel

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
ERROR_INVALID_HANDLE
 Ein ungültiges Handle wurde an die Funktion übergeben.
ERROR_SUCCESS
 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

Weitere Informationen

Handleverwaltungsfunktionen