Funzione NtCommitTransaction (wdm.h)

Articolo
07/02/2025

La routine ZwCommitTransaction avvia un'operazione di commit per una transazione specificata.

Sintassi

C++

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

Parametri

[in] TransactionHandle

Handle per un oggetto transazione . Il componente riceve questo handle da ZwCreateTransaction o ZwOpenTransaction. L'handle deve avere TRANSACTION_COMMIT 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 è TRUE, la chiamata viene restituita al termine dell'operazione di commit.

Valore restituito

ZwCommitTransaction 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 per il parametro TransactionHandle non è un handle per un oggetto transazione.
STATUS_INVALID_HANDLE	L'handle dell'oggetto transazione specificato non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto transazione.
STATUS_TRANSACTION_SUPERIOR_EXISTS	Il chiamante non può eseguire il commit della transazione perché esiste un gestore transazioni superiore.
STATUS_TRANSACTION_ALREADY_ABORTED	Impossibile eseguire il commit della transazione perché è stato eseguito il rollback.
STATUS_TRANSACTION_ALREADY_COMMITTED	È già stato eseguito il commit della transazione.
STATUS_TRANSACTION_REQUEST_NOT_VALID	L'operazione di commit per questa transazione è già stata avviata.
STATUS_PENDING	Le notifiche di commit sono state accodate ai gestori di risorse e il chiamante specificato false per il parametro Wait.

La routine potrebbe restituire altri valori NTSTATUS .

Osservazioni

Per altre informazioni sul modo in cui i client delle transazioni devono usare la routine ZwCommitTransaction, vedere Creating a Transactional Client.

Per altre informazioni sulle operazioni di commit, vedere Gestione delle operazioni di commit.

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
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