Funzione TmCommitTransaction (wdm.h)

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

Sintassi

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

Parametri

[in] Transaction

Puntatore a un oggetto transazione. Per ottenere questo puntatore, il componente TPS deve chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto che una chiamata precedente a ZwCreateTransaction o ZwOpenTransaction fornita.

[in] Wait

Valore booleano impostato sul chiamante su TRUE per l'operazione sincrona o FALSE per l'operazione asincrona. Se questo parametro è TRUE, la chiamata viene restituita dopo il completamento dell'operazione di commit.

Valore restituito

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

Codice restituito	Descrizione
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	La transazione è già sottoposta a commit.
STATUS_TRANSACTION_REQUEST_NOT_VALID	L'operazione di commit per questa transazione è già stata avviata.
STATUS_PENDING	Le notifiche di commit sono state accodate a gestione risorse e il chiamante specificato FALSE per il parametro Wait .

 

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

La routine TmCommitTransaction è una versione basata su puntatore della routine ZwCommitTransaction .

Per informazioni su quando usare le routine TmXxx di KTM anziché le routine Zw Xxx, vedere Uso di routine TmXxx.

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, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Vedi anche

ObReferenceObjectByHandle

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction