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

ObjectInformationバッファーで返される情報の種類を決定するOBJECT_INFORMATION_CLASS値を指定します。

[out, optional] ObjectInformation

要求された情報を受信する呼び出し元によって割り当てられたバッファーへのポインター。

[in] ObjectInformationLength

ObjectInformation バッファーのサイズをバイト単位で指定します。

[out, optional] ReturnLength

要求されたキー情報のサイズ (バイト単位) を受け取る変数へのポインター。 ZwQueryObject がSTATUS_SUCCESSを返す場合、変数には返されるデータの量が含まれます。 ZwQueryObject がSTATUS_BUFFER_OVERFLOWまたはSTATUS_BUFFER_TOO_SMALLを返す場合は、変数の値を使用して、必要なバッファー サイズを決定できます。

戻り値

ZwQueryObject は、STATUS_SUCCESSまたは適切なエラー状態を返します。 考えられるエラー状態コードは次のとおりです。

リターン コード 説明
STATUS_ACCESS_DENIED
このクエリを実行するためのアクセス許可が不十分でした。
STATUS_INVALID_HANDLE
 指定されたオブジェクト ハンドルが無効です。
STATUS_INFO_LENGTH_MISMATCH
 情報の長さは、データを保持するのに十分ではありません。

注釈

ZwQueryObject 関数の呼び出しがユーザー モードで行われる場合は、"ZwQueryObject" ではなく"NtQueryObject" という名前を使用する必要があります。

カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なります。 ルーチンの NtXxx バージョンと ZwXxx バージョン間の関係の詳細については、「Using Nt and Zw Versions of the Native System Services Routines」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000。
対象プラットフォーム ユニバーサル
Header ntifs.h (Ntifs.h、FltKernel.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

Nt および Zw バージョンのネイティブ システム サービス ルーチンの使用