Função NtQueryInformationEnlistment (wdm.h)

Artigo
02/07/2025

A rotina de ZwQueryInformationEnlistment recupera informações sobre um objeto de inscrição especificado.

Sintaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationEnlistment(
  [in]            HANDLE                       EnlistmentHandle,
  [in]            ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [out]           PVOID                        EnlistmentInformation,
  [in]            ULONG                        EnlistmentInformationLength,
  [out, optional] PULONG                       ReturnLength
);

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

[in] EnlistmentInformationClass

Um valor de enumeração tipo ENLISTMENT_INFORMATION_CLASSque especifica as informações a serem obtidas. Esse valor deve ser um dos seguintes valores:

EnlistmentBasicInformation
EnlistmentRecoveryInformation

O valor EnlistmentFullInformation da enumeração não é usado com ZwQueryInformationEnlistment.

[out] EnlistmentInformation

Um ponteiro para um buffer alocado por chamador que recebe as informações especificadas pelo parâmetro EnlistmentInformationClass . Se o valor do parâmetro EnlistmentInformationClass for EnlistmentBasicInformation, o tipo de estrutura desse buffer deverá ser ENLISTMENT_BASIC_INFORMATION. Se o valor do parâmetro EnlistmentInformationClass for EnlistmentRecoveryInformation, esse tipo de buffer deverá corresponder ao tipo definido pelo chamador usado quando ele chamou ZwSetInformationEnlistment.

[in] EnlistmentInformationLength

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

[out, optional] ReturnLength

Um ponteiro para uma variável alocada por chamador que recebe o comprimento, em bytes, das informações que o KTM grava no buffer EnlistmentInformation . Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

ZwQueryInformationEnlistment retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina poderá 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 de 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 .

Observações

Um gerenciador de recursos pode chamar ZwSetInformationEnlistment para definir informações de recuperação específicas de inscrição para um objeto de inscrição e, em seguida, chamar ZwQueryInformationEnlistment para recuperar as informações de recuperação.

Para obter mais informações sobre ZwQueryInformationEnlistment, consulte Handling Recovery Operations.

Os chamadores de ZwQueryInformationEnlistment devem estar em execução no IRQL = PASSIVE_LEVEL.

NtQueryInformationEnlistment e ZwQueryInformationEnlistment 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 versões de uma rotina dos Serviços de 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 de serviços do sistema nativo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores do sistema operacional.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs, PowerIrpDDis