Função TmPrepareEnlistment (wdm.h)
A rotina TmPrepareEnlistment inicia a operação de pré-preparação para uma transação de inscrição especificada.
Sintaxe
NTSTATUS TmPrePrepareEnlistment(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Parâmetros
[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.
Retornar valor
TmPreprepareEnlistment 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 |
|---|---|
|
O chamador não é um gerenciador de transações superior para a inscrição. |
|
O chamador não se registrou para receber TRANSACTION_NOTIFY_PREPREPARE_COMPLETE notificações. |
|
O estado da transação não permite que ela insira a fase de pré-preparação. |
|
O chamador não tem acesso apropriado ao objeto de inscrição. |
A rotina pode retornar outros valores NTSTATUS.
Comentários
A rotina TmPreprepareEnlistment é uma versão baseada em ponteiro da rotina ZwPrePrepareEnlistment .
Somente gerentes de transações superiores podem chamar TmPrepareEnlistment.
Para obter informações sobre quando usar rotinas TmXxx da KTM em vez de rotinas ZwXxx , consulte Usando rotinas TmXxx.
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, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |