TmCommitTransaction-Funktion (wdm.h)

Die TmCommitTransaction-Routine initiiert einen Commitvorgang für eine angegebene Transaktion.

Syntax

NTSTATUS TmCommitTransaction(
  [in] PKTRANSACTION Transaction,
  [in] BOOLEAN       Wait
);

Parameter

[in] Transaction

Ein Zeiger auf ein Transaktionsobjekt. Um diesen Zeiger zu erhalten, muss Ihre TPS-Komponente ObReferenceObjectByHandle aufrufen und das Objekthandle bereitstellen, das ein vorheriger Aufruf von ZwCreateTransaction oder ZwOpenTransaction bereitgestellt hat.

[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 TRUE ist, wird der Aufruf nach Abschluss des Commitvorgangs zurückgegeben.

Rückgabewert

TmCommitTransaction 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_TRANSACTION_SUPERIOR_EXISTS	Der Aufrufer kann die Transaktion nicht committen, da ein übergeordneter Transaktions-Manager vorhanden ist.
STATUS_TRANSACTION_ALREADY_ABORTED	Für die Transaktion kann kein Commit ausgeführt werden, da ein Rollback ausgeführt wurde.
STATUS_TRANSACTION_ALREADY_COMMITTED	Für die Transaktion wurde bereits ein Commit ausgeführt.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Der Commitvorgang für diese Transaktion wurde bereits gestartet.
STATUS_PENDING	Commitbenachrichtigungen 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

Die TmCommitTransaction-Routine ist eine zeigerbasierte Version der ZwCommitTransaction-Routine .

Informationen dazu, wann die TmXxx-Routinen von KTM anstelle von ZwXxx-Routinen verwendet werden sollen, finden Sie unter Verwenden von TmXxx-Routinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

ObReferenceObjectByHandle

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction