Função NtQueryObject (ntifs.h)

A rotina NtQueryObject fornece informações sobre um objeto fornecido.

Sintaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryObject(
  [in, optional]  HANDLE                   Handle,
  [in]            OBJECT_INFORMATION_CLASS ObjectInformationClass,
  [out, optional] PVOID                    ObjectInformation,
  [in]            ULONG                    ObjectInformationLength,
  [out, optional] PULONG                   ReturnLength
);

Parâmetros

[in, optional] Handle

Um identificador para o objeto sobre o qual obter informações.

[in] ObjectInformationClass

Especifica um valor OBJECT_INFORMATION_CLASS que determina o tipo de informações retornadas no buffer ObjectInformation .

[out, optional] ObjectInformation

Um ponteiro para um buffer alocado pelo chamador que recebe as informações solicitadas.

[in] ObjectInformationLength

Especifica o tamanho, em bytes, do buffer ObjectInformation .

[out, optional] ReturnLength

Um ponteiro para uma variável que recebe o tamanho, em bytes, das informações de chave solicitadas. Se NtQueryObject retornar STATUS_SUCCESS, a variável conterá a quantidade de dados retornados. Se NtQueryObject retornar STATUS_BUFFER_OVERFLOW ou STATUS_BUFFER_TOO_SMALL, você poderá usar o valor da variável para determinar o tamanho do buffer necessário.

Retornar valor

NtQueryObject retorna STATUS_SUCCESS ou um erro apropriado status. Os possíveis códigos de status de erro incluem o seguinte:

Código de retorno	Descrição
STATUS_ACCESS_DENIED	Não havia permissões suficientes para executar essa consulta.
STATUS_INVALID_HANDLE	O identificador de objeto fornecido é inválido.
STATUS_INFO_LENGTH_MISMATCH	O comprimento das informações não é suficiente para manter os dados.

Comentários

Se a chamada para a função NtQueryObject ocorrer no modo de usuário, você deverá usar o nome "NtQueryObject" em vez de "ZwQueryObject".

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do 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 dos Serviços de Sistema Nativo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h, FltKernel.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs, PowerIrpDDis

Confira também

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION