Função TmCommitEnlistment (wdm.h)

A rotina TmCommitEnlistment inicia a operação de confirmação para uma transação de inscrição especificada.

Sintaxe

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

[in] Enlistment

Um ponteiro para um objeto de alistamento. Seu componente pode receber esse ponteiro como entrada para uma rotina de retorno de chamada ResourceManagerNotification . Como alternativa, seu componente pode chamar ObReferenceObjectByHandle e fornecer o identificador de objeto que uma chamada anterior para ZwCreateEnlistment, TmCreateEnlistment ou ZwOpenEnlistment forneceu.

[in] TmVirtualClock

Um ponteiro para um valor de relógio virtual. Esse parâmetro é opcional e pode ser NULL.

TmCommitEnlistment retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_ENLISTMENT_NOT_SUPERIOR	O chamador não é um gerenciador de transações superior para a inscrição.
STATUS_TRANSACTION_RESPONSE_NOT_ENLISTED	O chamador não se registrou para receber TRANSACTION_NOTIFY_COMMIT_COMPLETE notificações.
STATUS_TRANSACTION_REQUEST_NOT_VALID	A transação do alistamento não está em um estado que permite que ela seja confirmada.
STATUS_TRANSACTION_NOT_ACTIVE	A operação de confirmação dessa transação já foi iniciada.
STATUS_TRANSACTION_ALREADY_ABORTED	A transação não pode ser confirmada porque foi revertida.

A rotina pode retornar outros valores NTSTATUS.

A rotina TmCommitEnlistment é uma versão baseada em ponteiro da rotina ZwCommitEnlistment .

Somente gerentes de transações superiores podem chamar TmCommitEnlistment.

Para obter informações sobre quando usar rotinas TmXxx da KTM em vez de rotinas ZwXxx , consulte Usando rotinas TmXxx.

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do sistema operacional.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL