Funzione ZwQueryObject (ntifs.h)

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.

Commenti

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 versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows 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 .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

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

Vedi anche

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema