Funzione NtQueryObject (ntifs.h)
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 |