Funzione NtCommitTransaction (wdm.h)

Articolo
02/27/2024

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

Sintassi

__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 ha specificato FALSE per il parametro Wait .

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Per altre informazioni sul modo in cui i client delle transazioni devono usare la routine ZwCommitTransaction , vedere Creazione di un client transazionale.

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

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 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

Vedi anche

TmCommitTransaction

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

ZwCreateTransaction

ZwOpenTransaction

Condividi tramite