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 |
---|---|
|
Autorizzazioni insufficienti per eseguire questa query. |
|
L'handle dell'oggetto fornito non è valido. |
|
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
PUBLIC_OBJECT_BASIC_INFORMATION
PUBLIC_OBJECT_TYPE_INFORMATION
Uso delle versioni Nt e Zw delle routine native di Servizi di sistema