Funzione NtRollbackTransaction (wdm.h)

Articolo
08/08/2023

La routine ZwRollbackTransaction avvia un'operazione di rollback per una transazione specificata.

Sintassi

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

Parametri

[in] TransactionHandle

Handle per un oggetto transazione ottenuto da una chiamata precedente a ZwCreateTransaction o ZwOpenTransaction. L'handle deve avere TRANSACTION_ROLLBACK accesso all'oggetto .

[in] Wait

Valore booleano impostato dal chiamante su TRUE per l'operazione sincrona o FALSE per l'operazione asincrona. Se questo parametro è impostato su TRUE, la chiamata non restituisce fino al completamento dell'operazione di rollback.

Valore restituito

ZwRollbackTransaction restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato dal parametro TransactionHandle non è un handle per un oggetto transazione.
STATUS_INVALID_HANDLE	Un handle di oggetto non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto transazione.
STATUS_TRANSACTION_ALREADY_COMMITTED	Impossibile eseguire il rollback della transazione perché è già stato eseguito il commit.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Il commit della transazione non è stato eseguito, ma lo stato corrente non consente il rollback.
STATUS_PENDING	Le notifiche di rollback sono state accodate ai gestori di risorse e il chiamante ha specificato FALSE per il parametro Wait .

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Per altre informazioni su ZwRollbackTransaction, vedere Gestione delle operazioni di rollback.

NtRollbackEnlistment e ZwRollbackEnlistment sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis

Vedi anche

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction

Condividi tramite