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或適當的錯誤狀態。 可能的錯誤狀態代碼包括下列專案：

言論

如果在使用者模式中呼叫 ZwQueryObject 函式，您應該使用名稱 “NtQueryObject” 而不是 “ZwQueryObject”。

對於內核模式驅動程式的呼叫，NtXxx 和 ZwXxx 版本的 Windows 原生系統服務例程，在處理和解譯輸入參數的方式上可能會有不同的行為。 如需 nt NtXxx 與 ZwXxx 例程之間關聯性的詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。

要求

另請參閱

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

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