TmRollbackTransaction-Funktion (wdm.h)
Die TmRollbackTransaction-Routine initiiert einen Rollbackvorgang für eine angegebene Transaktion.
Syntax
NTSTATUS TmRollbackTransaction(
[in] PKTRANSACTION Transaction,
[in] BOOLEAN Wait
);
Parameter
[in] Transaction
Ein Zeiger auf ein Transaktionsobjekt. Um diesen Zeiger zu erhalten, muss Ihre 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 auf TRUE festgelegt ist, wird der Aufruf erst zurückgegeben, wenn der Rollbackvorgang abgeschlossen ist.
Rückgabewert
TmRollbackTransaction 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 |
|---|---|
|
Für die Transaktion kann kein Rollback ausgeführt werden, da bereits ein Commit ausgeführt wurde. |
|
Die Transaktion wurde nicht committet, aber ihr aktueller Status lässt kein Rollback zu. |
|
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
Die TmRollbackTransaction-Routine ist eine zeigerbasierte Version der ZwRollbackTransaction-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 |