Funzione NtQueryObject (ntifs.h)

Articolo
03/05/2024

La routine NtQueryObject fornisce informazioni su un oggetto fornito.

Sintassi

__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
);

Parametri

[in, optional] Handle

Handle dell'oggetto per ottenere informazioni su.

[in] ObjectInformationClass

Specifica un valore OBJECT_INFORMATION_CLASS che determina il tipo di informazioni restituite nel buffer ObjectInformation .

[out, optional] ObjectInformation

Puntatore a un buffer allocato dal chiamante che riceve le informazioni richieste.

[in] ObjectInformationLength

Specifica le dimensioni, in byte, del buffer ObjectInformation .

[out, optional] ReturnLength

Puntatore a una variabile che riceve le dimensioni, in byte, delle informazioni sulla chiave richiesta. Se NtQueryObject restituisce STATUS_SUCCESS, la variabile contiene la quantità di dati restituiti. Se NtQueryObject restituisce STATUS_BUFFER_OVERFLOW o STATUS_BUFFER_TOO_SMALL, è possibile usare il valore della variabile per determinare le dimensioni del buffer necessarie.

Valore restituito

NtQueryObject restituisce STATUS_SUCCESS o uno stato di errore appropriato. I codici di stato degli errori possibili includono quanto segue:

Codice restituito	Descrizione
STATUS_ACCESS_DENIED	Per eseguire questa query sono state eseguite autorizzazioni insufficienti.
STATUS_INVALID_HANDLE	L'handle oggetto fornito non è valido.
STATUS_INFO_LENGTH_MISMATCH	La lunghezza delle informazioni non è sufficiente per contenere i dati.

Commenti

Se la chiamata alla funzione NtQueryObject si verifica in modalità utente, è necessario usare il nome "NtQueryObject" anziché "ZwQueryObject".

Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Uso di nt e zw versioni delle routine di Servizi di sistema nativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h, FltKernel.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis

Vedi anche

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

Share via