Funzione TmCommitEnlistment (wdm.h)

Articolo
08/08/2023

La routine TmCommitEnlistment avvia l'operazione di commit per una transazione di inserimento specificata.

Sintassi

NTSTATUS TmCommitEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Parametri

[in] Enlistment

Puntatore a un oggetto di inserimento. Il componente può ricevere questo puntatore come input a una routine di callback resourceManagerNotification . In alternativa, il componente può chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto che una chiamata precedente a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment fornito.

[in] TmVirtualClock

Puntatore a un valore di orologio virtuale. Questo parametro è facoltativo e può essere NULL.

Valore restituito

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

Codice restituito	Descrizione
STATUS_ENLISTMENT_NOT_SUPERIOR	Il chiamante non è un gestore delle transazioni superiore per l'inserimento.
STATUS_TRANSACTION_RESPONSE_NOT_ENLISTED	Il chiamante non è stato registrato per ricevere notifiche di TRANSACTION_NOTIFY_COMMIT_COMPLETE.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La transazione dell'elenco non è in uno stato che lo consente di eseguire il commit.
STATUS_TRANSACTION_NOT_ACTIVE	L'operazione di commit per questa transazione è già stata avviata.
STATUS_TRANSACTION_ALREADY_ABORTED	Impossibile eseguire il commit della transazione perché è stato eseguito il rollback.

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

La routine TmCommitEnlistment è una versione basata su puntatore della routine ZwCommitEnlistment .

Solo i responsabili delle transazioni superiori possono chiamare TmCommitEnlistment.

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