Compartilhar via


Função ZwRollbackEnlistment (wdm.h)

A rotina ZwRollbackEnlistment reverte a transação associada a uma inscrição especificada.

Sintaxe

NTSYSCALLAPI NTSTATUS ZwRollbackEnlistment(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

Parâmetros

[in] EnlistmentHandle

Um identificador para um objeto de inscrição que foi obtido por uma chamada anterior para ZwCreateEnlistment ou ZwOpenEnlistment. O identificador deve ter ENLISTMENT_SUBORDINATE_RIGHTS acesso ao objeto .

[in, optional] TmVirtualClock

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

Retornar valor

ZwRollbackEnlistment 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 não é um identificador para um objeto de inscrição.
STATUS_INVALID_HANDLE
O identificador do objeto é inválido.
STATUS_TRANSACTION_REQUEST_NOT_VALID
O alistamento não pode ser revertido.
STATUS_ACCESS_DENIED
O chamador não tem acesso apropriado ao objeto de inscrição.
 

A rotina pode retornar outros valores NTSTATUS.

Comentários

Um gerenciador de recursos pode chamar ZwRollbackEnlistment para reverter uma transação a qualquer momento antes de chamar ZwPrepareComplete.

Para obter mais informações sobre ZwRollbackEnlistment, 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

TmRollbackEnlistment

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

ZwCreateEnlistment

ZwOpenEnlistment

ZwPrepareComplete