Função NtSetInformationEnlistment (wdm.h)

  • Artigo

A rotina ZwSetInformationEnlistment define informações para um objeto de inscrição especificado.

Sintaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationEnlistment(
  [in] HANDLE                       EnlistmentHandle,
  [in] ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [in] PVOID                        EnlistmentInformation,
  [in] ULONG                        EnlistmentInformationLength
);

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_SET_INFORMATION acesso ao objeto .

[in] EnlistmentInformationClass

Um valor de enumeração tipo ENLISTMENT_INFORMATION_CLASS que especifica o tipo de informação a ser definido. Esse valor deve ser EnlistmentRecoveryInformation.

Os valores EnlistmentBasicInformation e EnlistmentFullInformation da enumeração não são usados com ZwSetInformationEnlistment.

[in] EnlistmentInformation

Um ponteiro para um buffer alocado pelo chamador que contém informações de recuperação definidas pelo chamador para a inscrição.

[in] EnlistmentInformationLength

O comprimento, em bytes, do buffer para o qual o parâmetro EnlistmentInformation aponta.

Retornar valor

ZwSetInformationEnlistment 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_INVALID_INFO_CLASS
 O valor do parâmetro EnlistmentInformationClass é inválido.
STATUS_INFO_LENGTH_MISMATCH
 O valor do parâmetro EnlistmentInformationLength é inválido.
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 usar a rotina ZwSetInformationEnlistment para definir informações de recuperação para uma inscrição. A KTM grava as informações de recuperação no fluxo de log e o gerenciador de recursos pode chamar ZwQueryInformationEnlistment para ler essas informações do fluxo de log a qualquer momento.

Cada chamada subsequente para ZwSetInformationEnlistment exclui as informações de recuperação especificadas pela chamada anterior antes de armazenar as novas informações de recuperação.

Para obter mais informações sobre como usar ZwSetInformationEnlistment, consulte Usando fluxos de log com KTM.

NtSetInformationEnlistment e ZwSetInformationEnlistment são duas versões da mesma rotina do Windows Native System Services.

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

Confira também

ENLISTMENT_INFORMATION_CLASS

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

ZwCreateEnlistment

ZwOpenEnlistment

ZwQueryInformationEnlistment