Função NtPrePrepareEnlistment (wdm.h)

  • Artigo

A rotina ZwPrePrepareEnlistment inicia a operação de pré-preparação para uma transação de inscrição especificada.

Sintaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtPrePrepareEnlistment(
  [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 objeto deve representar uma inscrição superior e o identificador deve ter ENLISTMENT_SUPERIOR_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

ZwPrePrepareEnlistment 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_PREPREPARE_COMPLETE notificações.
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_ACCESS_DENIED
 O chamador não tem acesso apropriado ao objeto de inscrição.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 A transação da inscrição não está em um estado que permite que ela entre na fase de preparação.
 

A rotina pode retornar outros valores NTSTATUS.

Comentários

Somente gerenciadores de transações superiores podem chamar ZwPrepareEnlistment.

Os chamadores de ZwPrePrepareEnlistment devem se registrar para receber TRANSACTION_NOTIFY_PREPREPARE_COMPLETE notificações.

A rotina ZwPrePrepareEnlistment faz com que o KTM envie TRANSACTION_NOTIFY_PREPREPARE notificações para todos os gerenciadores de recursos que se inscreveram na transação.

Para obter mais informações sobre ZwPrePrepareEnlistment, consulte Criando um gerenciador de transações superior e tratando operações de confirmação.

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

Para chamadas de drivers de modo kernel, as versões NtXxx e ZwXxx de uma rotina do Windows Native System Services 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 Using Nt and Zw Versions of the Native System Services Routines.

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 (include Wdm.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDDIs, PowerIrpDDis

Confira também

TmPrePrepareEnlistment

Usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwCreateEnlistment

ZwOpenEnlistment