Função ZwRollbackTransaction (wdm.h)

  • Artigo

A rotina ZwRollbackTransaction inicia uma operação de reversão para uma transação especificada.

Sintaxe

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

Parâmetros

[in] TransactionHandle

Um identificador para um objeto de transação que foi obtido por uma chamada anterior para ZwCreateTransaction ou ZwOpenTransaction. O identificador deve ter TRANSACTION_ROLLBACK 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 definido como TRUE, a chamada não retornará até que a operação de reversão seja concluída.

Retornar valor

ZwRollbackTransaction 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 que o parâmetro TransactionHandle especifica não é um identificador para um objeto de transação.
STATUS_INVALID_HANDLE
 Um identificador de objeto é inválido.
STATUS_ACCESS_DENIED
 O chamador não tem acesso apropriado ao objeto de transação.
STATUS_TRANSACTION_ALREADY_COMMITTED
 A transação não pode ser revertida porque já foi confirmada.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 A transação não foi confirmada, mas seu estado atual não permite a reversão.
STATUS_PENDING
 As notificações de reversã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 ZwRollbackTransaction, consulte Manipulando operações de reversão.

NtRollbackEnlistment e ZwRollbackEnlistment são duas versões da mesma rotina dos Serviços do Sistema Nativo do Windows.

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 sistema operacional.
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

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

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction