ntQueryObject 函式 (ntifs.h)
NtQueryObject 例程會提供所提供對象的相關信息。
語法
__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
);
參數
[in, optional] Handle
要取得相關信息的物件句柄。
[in] ObjectInformationClass
指定 OBJECT_INFORMATION_CLASS 值，決定 ObjectInformation 緩衝區中傳回的信息類型。
[out, optional] ObjectInformation
呼叫端配置的緩衝區指標，可接收要求的資訊。
[in] ObjectInformationLength
指定 ObjectInformation 緩衝區的大小，以位元組為單位。
[out, optional] ReturnLength
接收所要求金鑰資訊大小之變數的指標，以位元組為單位。 如果 NtQueryObject 傳回STATUS_SUCCESS，變數會包含傳回的數據量。 如果 NtQueryObject 傳回STATUS_BUFFER_OVERFLOW或STATUS_BUFFER_TOO_SMALL，您可以使用變數的值來判斷所需的緩衝區大小。
傳回值
NtQueryObject 會傳回STATUS_SUCCESS或適當的錯誤狀態。 可能的錯誤狀態代碼包括：
| 傳回碼 | Description |
|---|---|
| STATUS_ACCESS_DENIED | 沒有足夠的許可權可執行此查詢。 |
| STATUS_INVALID_HANDLE | 提供的物件句柄無效。 |
| STATUS_INFO_LENGTH_MISMATCH | 信息長度不足以保存數據。 |
備註
如果使用者模式中發生 對 NtQueryObject 函式的呼叫，您應該使用名稱 “NtQueryObject”，而不是 “ZwQueryObject”。
針對來自內核模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本會以處理和解譯輸入參數的方式，以不同的方式運作。 如需 例程 NtXxx 和 ZwXxx 版本之間關聯性的詳細資訊，請參閱 使用原生系統服務例程的 Nt 和 Zw 版本。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000。 |
| 目標平台 | Universal |
| 標頭 | ntifs.h (包括 Ntifs.h、FltKernel.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDDIs、PowerIrpDDis |