NtCommitTransaction-Funktion (wdm.h)

Artikel
02/07/2025

Die ZwCommitTransaction Routine initiiert einen Commit-Vorgang für eine angegebene Transaktion.

Syntax

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

Parameter

[in] TransactionHandle

Ein Handle für ein Transaktionsobjekt. Ihre Komponente empfängt dieses Handle von ZwCreateTransaction oder ZwOpenTransaction-. Das Handle muss über TRANSACTION_COMMIT Zugriff auf das Objekt verfügen.

[in] Wait

Ein boolescher Wert, den der Aufrufer auf TRUE- für synchronen Vorgang oder FALSE- für asynchronen Vorgang festlegt. Wenn dieser Parameter TRUEist, gibt der Aufruf nach Abschluss des Commitvorgangs zurück.

Rückgabewert

ZwCommitTransaction- 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 für den TransactionHandle Parameter angegeben wurde, ist kein Handle für ein Transaktionsobjekt.
STATUS_INVALID_HANDLE	Das angegebene Transaktionsobjekthandle ist ungültig.
STATUS_ACCESS_DENIED	Der Aufrufer hat keinen geeigneten Zugriff auf das Transaktionsobjekt.
STATUS_TRANSACTION_SUPERIOR_EXISTS	Der Aufrufer kann die Transaktion nicht übernehmen, da ein überlegener Transaktionsmanager vorhanden vorhanden ist.
STATUS_TRANSACTION_ALREADY_ABORTED	Die Transaktion kann nicht zugesichert werden, weil sie zurückgesetzt wurde.
STATUS_TRANSACTION_ALREADY_COMMITTED	Die Transaktion ist bereits zugesichert.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Der Commitvorgang für diese Transaktion wurde bereits gestartet.
STATUS_PENDING	Commitbenachrichtigungen wurden an Ressourcenmanager in die Warteschlange gestellt, und der Aufrufer, der FALSE- für den Parameter Wait angegeben wurde.

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

Bemerkungen

Weitere Informationen dazu, wie Transaktionsclients die ZwCommitTransaction--Routine verwenden sollten, finden Sie unter Creating a Transactional Client.

Weitere Informationen zu Commitvorgängen finden Sie unter Behandeln von Commit-Vorgängen.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx und ZwXxx- Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs, PowerIrpDDis

Siehe auch

TmCommitTransaction-

Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienste-Routinen

ZwCreateTransaction-

ZwOpenTransaction-

Freigeben über