Funzione ZwQueryObject (ntifs.h)

Articolo
12/21/2024

La routine ZwQueryObject fornisce informazioni su un oggetto fornito.

Sintassi

NTSYSAPI NTSTATUS ZwQueryObject(
  [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 per l'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 ZwQueryObject restituisce STATUS_SUCCESS, la variabile contiene la quantità di dati restituiti. Se ZwQueryObject restituisce STATUS_BUFFER_OVERFLOW o STATUS_BUFFER_TOO_SMALL, è possibile usare il valore della variabile per determinare le dimensioni del buffer necessarie.

Valore restituito

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

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

Osservazioni

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

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni 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 Using Nt and Zw Versions of the Native System Services Routines.

Fabbisogno

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(storport), PowerIrpDDis(wdm)

Vedere anche

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

uso di versioni Nt e Zw delle routine di Servizi di sistema nativi

Condividi tramite