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 |
---|---|
|
Não havia permissões suficientes para executar essa consulta. |
|
O identificador de objeto fornecido é inválido. |
|
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
PUBLIC_OBJECT_BASIC_INFORMATION
PUBLIC_OBJECT_TYPE_INFORMATION
Usando versões Nt e Zw das rotinas de serviços do sistema nativo