次の方法で共有

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 バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt および Zw バージョンの使用 を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000。
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h、FltKernel.h を含む)
ライブラリ 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 バージョンを使用した