Função NtQueryInformationEnlistment (wdm.h)

Artigo
08/08/2023

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

[in] EnlistmentInformationClass

Um valor de enumeração tipo ENLISTMENT_INFORMATION_CLASS que 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 pelo 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, o tipo desse buffer deverá corresponder ao tipo definido pelo chamador que o chamador usou quando 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 pelo 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.

Retornar valor

ZwQueryInformationEnlistment 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 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 Manipulando operações de recuperação.

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

NtQueryInformationEnlistment e ZwQueryInformationEnlistment 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