Freigeben über


ZwRollbackTransaction-Funktion (wdm.h)

Die ZwRollbackTransaction-Routine initiiert einen Rollbackvorgang für eine angegebene Transaktion.

Syntax

NTSYSCALLAPI NTSTATUS ZwRollbackTransaction(
  [in] HANDLE  TransactionHandle,
  [in] BOOLEAN Wait
);

Parameter

[in] TransactionHandle

Ein Handle für ein Transaktionsobjekt , das durch einen vorherigen Aufruf von ZwCreateTransaction oder ZwOpenTransaction abgerufen wurde. Das Handle muss über TRANSACTION_ROLLBACK Zugriff auf das Objekt verfügen.

[in] Wait

Ein boolescher Wert, den der Aufrufer für den synchronen Betrieb auf TRUE oder FALSE für asynchronen Vorgang festlegt. Wenn dieser Parameter auf TRUE festgelegt ist, wird der Aufruf erst zurückgegeben, wenn der Rollbackvorgang abgeschlossen ist.

Rückgabewert

ZwRollbackTransaction gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_OBJECT_TYPE_MISMATCH
Das Handle, das der TransactionHandle-Parameter angibt, ist kein Handle für ein Transaktionsobjekt.
STATUS_INVALID_HANDLE
Ein Objekthandle ist ungültig.
STATUS_ACCESS_DENIED
Der Aufrufer hat keinen geeigneten Zugriff auf das Transaktionsobjekt.
STATUS_TRANSACTION_ALREADY_COMMITTED
Für die Transaktion kann kein Rollback ausgeführt werden, da bereits ein Commit ausgeführt wurde.
STATUS_TRANSACTION_REQUEST_NOT_VALID
Die Transaktion wurde nicht committet, aber ihr aktueller Status lässt kein Rollback zu.
STATUS_PENDING
Rollbackbenachrichtigungen wurden für Ressourcen-Manager in die Warteschlange eingereiht, und der Aufrufer hat false für den Wait-Parameter angegeben.
 

Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.

Hinweise

Weitere Informationen zu ZwRollbackTransaction finden Sie unter Behandeln von Rollbackvorgängen.

NtRollbackEnlistment und ZwRollbackEnlistment sind zwei Versionen derselben Windows Native System Services-Routine.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform Universell
Header wdm.h (include Wdm.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction