MsiEndTransaction-Funktion (msi.h)
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 |
|---|---|
|
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. |
|
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 |
|---|---|
|
Eine Transaktion kann nur vom aktuellen Besitzer beendet werden. |
|
Eine Installation, die zur Transaktion gehört, konnte nicht abgeschlossen werden. |
|
Eine Installation, die zur Transaktion gehört, wird noch ausgeführt. |
|
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 |