Função NtQueryObject (ntifs.h)

A rotina de 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 por 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.

Valor de retorno

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

Observações

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 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

Consulte também

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION