Função ZwCommitTransaction (wdm.h)

A rotina ZwCommitTransaction inicia uma operação de confirmação para uma transação especificada.

Sintaxe

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

Parâmetros

[in] TransactionHandle

Um identificador para um objeto de transação. Seu componente recebe esse identificador de ZwCreateTransaction ou ZwOpenTransaction. O identificador deve ter TRANSACTION_COMMIT acesso ao objeto .

[in] Wait

Um valor booliano que o chamador define como TRUE para operação síncrona ou FALSE para operação assíncrona. Se esse parâmetro for TRUE, a chamada retornará após a conclusão da operação de confirmação.

Retornar valor

ZwCommitTransaction 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_OBJECT_TYPE_MISMATCH	O identificador especificado para o parâmetro TransactionHandle não é um identificador para um objeto de transação.
STATUS_INVALID_HANDLE	O identificador de objeto de transação especificado é inválido.
STATUS_ACCESS_DENIED	O chamador não tem acesso apropriado ao objeto de transação.
STATUS_TRANSACTION_SUPERIOR_EXISTS	O chamador não pode confirmar a transação porque existe um gerenciador de transações superior .
STATUS_TRANSACTION_ALREADY_ABORTED	A transação não pode ser confirmada porque foi revertida.
STATUS_TRANSACTION_ALREADY_COMMITTED	A transação já está confirmada.
STATUS_TRANSACTION_REQUEST_NOT_VALID	A operação de confirmação dessa transação já foi iniciada.
STATUS_PENDING	As notificações de confirmação foram enfileiradas para os gerenciadores de recursos e o chamador especificou FALSE para o parâmetro Wait .

 

A rotina pode retornar outros valores NTSTATUS.

Comentários

Para obter mais informações sobre como os clientes de transação devem usar a rotina ZwCommitTransaction , consulte Criando um cliente transacional.

Para obter mais informações sobre operações de confirmação, consulte Manipulando operações de confirmação.

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (inclua Wdm.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

TmCommitTransaction

Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo

ZwCreateTransaction

ZwOpenTransaction