MsiBeginTransactionA-Funktion (msi.h)

Artikel
08/24/2023

Die MsiBeginTransaction-Funktion startet die 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üher: 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 ist, schließt Windows Installer die Benutzeroberfläche der vorherigen Installation.
MSITRANSACTION_CHAIN_EMBEDDEDUI	Legen Sie dieses Attribut fest, um anzufordern, dass Windows Installer die eingebettete Benutzeroberfläche erst herunterfahren soll, wenn die Transaktion abgeschlossen ist.

[out] phTransactionHandle

Transaktions-ID ist ein MSIHANDLE-Wert , der die Transaktion identifiziert. Nur ein Prozess kann gleichzeitig besitzer einer Transaktion sein.

[out] phChangeOfOwnerEvent

Dieser Parameter gibt ein Handle für ein Ereignis zurück, das festgelegt wird, wenn die MsiJoinTransaction-Funktion den Besitzer der Transaktion in einen neuen Besitzer ändert. Der aktuelle Besitzer kann damit bestimmen, wann sich der Besitz der Transaktion geändert hat. Wenn eine Transaktion ohne einen Besitzer belassen wird, wird ein Rollback für die Transaktion ausgefü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. Diese Funktion erfordert den Windows Installer-Dienst.
ERROR_INSTALL_ALREADY_RUNNING	Es kann jeweils nur eine Transaktion auf einem System geöffnet sein. Die Funktion gibt diesen Fehler zurück, wenn sie aufgerufen wird, während eine andere Transaktion ausgeführt wird.
ERROR_INVALID_PARAMETER	Ein ungültiger Parameter wird an die Funktion übergeben.
ERROR_ROLLBACK_DISABLED	Rollbackinstallationen wurden durch die DISABLEROLLBACK-Eigenschaft oder die DisableRollback-Richtlinie deaktiviert.

Hinweise

Hinweis

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
Unterstützte Mindestversion (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 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

Mehrere Paketinstallationen

Freigeben über