Função ZwQueryObject (ntifs.h)

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

Sintaxe

NTSYSAPI NTSTATUS ZwQueryObject(
  [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ção retornado 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 ZwQueryObject retornar STATUS_SUCCESS, a variável conterá a quantidade de dados retornados. Se ZwQueryObject 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

ZwQueryObject retorna STATUS_SUCCESS ou um erro apropriado status. 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 ZwQueryObject ocorrer no modo de usuário, você deverá usar o nome "NtQueryObject" em vez de "ZwQueryObject".

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	Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (include Ntifs.h, FltKernel.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

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