zwQueryObject 函式 (ntifs.h)

ZwQueryObject 例程會提供所提供對象的相關信息。

語法

NTSYSAPI NTSTATUS ZwQueryObject(
  [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

接收所要求金鑰資訊大小之變數的指標，以位元組為單位。 如果 ZwQueryObject 傳回STATUS_SUCCESS，變數會包含傳回的數據量。 如果 ZwQueryObject 傳回STATUS_BUFFER_OVERFLOW或STATUS_BUFFER_TOO_SMALL，您可以使用變數的值來判斷所需的緩衝區大小。

傳回值

ZwQueryObject 會傳回STATUS_SUCCESS或適當的錯誤狀態。 可能的錯誤狀態代碼包括：

傳回碼	Description
STATUS_ACCESS_DENIED	沒有足夠的許可權可執行此查詢。
STATUS_INVALID_HANDLE	提供的物件句柄無效。
STATUS_INFO_LENGTH_MISMATCH	信息長度不足以保存數據。

備註

如果在使用者模式中呼叫 ZwQueryObject 函式，您應該使用名稱 「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 合規性規則	HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)

另請參閱

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

使用 Nt 和 Zw 版本的原生系統服務例程