Share via

MsiEndTransaction-Funktion (msi.h)

  • Artikel

Die MsiEndTransaction-Funktion kann alle Installationen committen oder rollbacken, die zur Transaktion gehören, die von der MsiBeginTransaction-Funktion geöffnet wurde. Diese Funktion sollte vom aktuellen Besitzer der Transaktion aufgerufen werden.

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

Syntax

UINT MsiEndTransaction(
  [in] DWORD dwTransactionState
);

Parameter

[in] dwTransactionState

Der Wert dieses Parameters bestimmt, ob das Installationsprogramm alle Installationen, die zur Transaktion gehören, committ oder ein Rollback ausführt. Der Wert kann einer der folgenden Sein.

Wert Bedeutung
MSITRANSACTIONSTATE_ROLLBACK
 Führt eine Rollbackinstallation aus, um Änderungen am System rückgängig zu machen, das zu der Transaktion gehört, die von der MsiBeginTransaction-Funktion geöffnet wurde.
MSITRANSACTIONSTATE_COMMIT
 Committ alle Änderungen an dem System, das zur Transaktion gehört. Führt alle Benutzerdefinierten Commitaktionen aus und committ alle Änderungen an Win32- oder Common Language Runtime-Assemblys an das System. Löscht das Rollbackskript, und nach Der Verwendung dieser Option können die Änderungen der Transaktion nicht mehr mit einer Rollbackinstallation rückgängig werden.

Rückgabewert

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

Wert Bedeutung
ERROR_ACCESS_DENIED
 Eine Transaktion kann nur vom aktuellen Besitzer beendet werden.
ERROR_INSTALL_FAILURE
 Eine Installation, die zur Transaktion gehört, konnte nicht abgeschlossen werden.
ERROR_INSTALL_ALREADY_RUNNING
 Eine Installation, die zur Transaktion gehört, wird noch ausgeführt.
ERROR_ROLLBACK_DISABLED
 Eine Installation, die zur Transaktion gehört, wurde nicht abgeschlossen. Während der Installation hat die DisableRollback-AktionRollback-Installationen des Pakets deaktiviert. Das Installationsprogramm führt ein Rollback für die Installation bis zu dem Punkt zurück, an dem das Rollback deaktiviert wurde, und die Funktion gibt diesen Fehler zurück.

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

Installationen mit mehreren Paketen