Função ZwQueryObject (ntifs.h)

Artigo
12/21/2024

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

Valor de retorno

ZwQueryObject retorna STATUS_SUCCESS ou um status de erro apropriado. Os códigos de status de erro possíveis 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 armazenar os dados.

Observações

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 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	Windows 2000.
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h, FltKernel.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte 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

Compartilhar via