MsiBeginTransactionA-Funktion (msi.h)

Artikel
11/20/2024

Die MsiBeginTransaction--Funktion startet Transaktionsverarbeitung einer Installation mit mehreren Paketen und gibt einen Bezeichner für die Transaktion zurück. Die MsiEndTransaction Funktion beendet die Transaktion.

Windows Installer 4.0 und frühere: Nicht unterstützt. Diese Funktion ist ab Windows Installer 4.5 verfügbar.

Syntax

UINT MsiBeginTransactionA(
  [in]  LPCSTR    szName,
  [in]  DWORD     dwTransactionAttributes,
  [out] MSIHANDLE *phTransactionHandle,
  [out] HANDLE    *phChangeOfOwnerEvent
);

Parameter

[in] szName

Name der Installation mit mehreren Paketen.

[in] dwTransactionAttributes

Attribute der Installation mit mehreren Paketen.

Wert	Bedeutung
0	Wenn 0 oder kein Wert festgelegt wird, schließt Windows Installer die Benutzeroberfläche aus der vorherigen Installation.
MSITRANSACTION_CHAIN_EMBEDDEDUI	Legen Sie dieses Attribut fest, um anzufordern, dass windows Installer die eingebettete Benutzeroberfläche erst herunterfahren, wenn die Transaktion abgeschlossen ist.

[out] phTransactionHandle

Die Transaktions-ID ist ein MSIHANDLE Wert, der die Transaktion identifiziert. Nur ein Prozess kann jeweils eine Transaktion besitzen.

[out] phChangeOfOwnerEvent

Dieser Parameter gibt ein Handle zu einem Ereignis zurück, das festgelegt wird, wenn die MsiJoinTransaction Funktion den Besitzer der Transaktion in einen neuen Besitzer ändert. Der aktuelle Besitzer kann dies verwenden, um zu bestimmen, wann sich der Besitz der Transaktion geändert hat. Wenn Sie eine Transaktion ohne besitzer verlassen, wird die Transaktion zurückgeführt.

Rückgabewert

Die MsiBeginTransaction--Funktion gibt die folgenden Werte zurück.

Wert	Bedeutung
ERROR_INSTALL_SERVICE_FAILURE	Auf den Installationsdienst konnte nicht zugegriffen werden. Für diese Funktion ist der Windows Installer-Dienst erforderlich.
ERROR_INSTALL_ALREADY_RUNNING	Es kann jeweils nur eine Transaktion auf einem System geöffnet werden. Die Funktion gibt diesen Fehler zurück, wenn eine andere Transaktion ausgeführt wird.
ERROR_INVALID_PARAMETER	An die Funktion wird ein ungültiger Parameter übergeben.
ERROR_ROLLBACK_DISABLED	Rollbackinstallationen wurden von der DISABLEROLLBACK-Eigenschaft oder DisableRollback--Richtlinie deaktiviert.

Bemerkungen

Anmerkung

Der msi.h-Header definiert MsiBeginTransaction als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.5 unter Windows Vista, Windows XP, Windows Server 2003 und Windows Server 2008. Informationen zum mindestens von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen.
Zielplattform-	Fenster
Header-	msi.h
Library	Msi.lib
DLL-	Msi.dll

Siehe auch

mehrere Paketinstallationen

Freigeben über