NtRollbackEnlistment-Funktion (wdm.h)

Artikel
02/29/2024

Die ZwRollbackEnlistment-Routine führt ein Rollback für die Transaktion aus, die einem angegebenen Eintrag zugeordnet ist.

Syntax

__kernel_entry NTSYSCALLAPI NTSTATUS NtRollbackEnlistment(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

Parameter

[in] EnlistmentHandle

Ein Handle für ein Eintragsobjekt , das durch einen vorherigen Aufruf von ZwCreateEnlistment oder ZwOpenEnlistment abgerufen wurde. Das Handle muss über ENLISTMENT_SUBORDINATE_RIGHTS Zugriff auf das Objekt verfügen.

[in, optional] TmVirtualClock

Ein Zeiger auf einen virtuellen Uhrwert. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

ZwRollbackEnlistment 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 angegebene Handle ist kein Handle für ein Eintragsobjekt.
STATUS_INVALID_HANDLE	Das Objekthandle ist ungültig.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Für die Einlistung kann kein Rollback ausgeführt werden.
STATUS_ACCESS_DENIED	Der Aufrufer hat keinen geeigneten Zugriff auf das Eintragsobjekt.

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

Hinweise

Ein Ressourcen-Manager kann ZwRollbackEnlistment aufrufen, um ein Rollback für eine Transaktion jederzeit auszuführen, bevor ZwPrepareComplete aufgerufen wird.

Weitere Informationen zu ZwRollbackEnlistment 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, PowerIrpDDis

Weitere Informationen

TmRollbackEnlistment

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateEnlistment

ZwOpenEnlistment

ZwPrepareComplete

Freigeben über