Share via

FltQueryQuotaInformationFile 関数 (fltkernel.h)

  • [アーティクル]

FltQueryQuotaInformationFile ルーチンは、ファイル オブジェクトに関連付けられているクォータ エントリを取得します。

構文

NTSTATUS FLTAPI FltQueryQuotaInformationFile(
  [in]            PFLT_INSTANCE    Instance,
  [in]            PFILE_OBJECT     FileObject,
  [out]           PIO_STATUS_BLOCK IoStatusBlock,
  [out]           PVOID            Buffer,
  [in]            ULONG            Length,
  [in]            BOOLEAN          ReturnSingleEntry,
  [in, optional]  PVOID            SidList,
  [in]            ULONG            SidListLength,
  [in, optional]  PULONG           StartSid,
  [in]            BOOLEAN          RestartScan,
  [out, optional] PULONG           LengthReturned
);

パラメーター

[in] Instance

呼び出し元の不透明なインスタンス ポインター。 このパラメーターは必須であり、 NULL にすることはできません。

[in] FileObject

開いているファイル、ディレクトリ、ストレージ デバイス、またはボリュームのファイル オブジェクト ポインター。 このパラメーターは必須であり、 NULL にすることはできません。

[out] IoStatusBlock

FltQueryQuotaInformationFile の呼び出しの結果を受け取る呼び出し元が指定したIO_STATUS_BLOCK。 無効な SID リストが原因で呼び出しが失敗した場合、[ 情報 ] フィールドには、エラーが発生した SidList 内の場所が含まれます。

[out] Buffer

呼び出し元が指定した FILE_GET_QUOTA_INFORMATION構造化入力バッファーへのポインター。クォータ情報の値が返されます。

[in] Length

Buffer パラメーターが指すバッファーの長さ (バイト単位)。

[in] ReturnSingleEntry

FltQueryQuotaInformationFile が最初に見つかったエントリのみを返す場合は TRUE に設定します。

[in, optional] SidList

クエリを実行するクォータ情報を指定する、呼び出し元が指定した FILE_GET_QUOTA_INFORMATION構造化入力バッファーへのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。

[in] SidListLength

SidList パラメーターが指すバッファーの長さ (バイト単位)。

[in, optional] StartSid

ファイルのクォータ情報リストのスキャンを開始するエントリのインデックス。 SidList パラメーターが空でないリストを指している場合、このパラメーターは無視されます。 このパラメーターは省略可能であり、 NULL にすることができます。

[in] RestartScan

FltQueryQuotaInformationFile がファイルのクォータ情報リストの最初のエントリでスキャンを開始する必要がある場合は、TRUE に設定します。 このパラメーターが TRUE に設定されていない場合、 FltQueryQuotaInformationFile の以前の呼び出しからスキャンが再開されます。

[out, optional] LengthReturned

Buffer で返される情報のサイズ (バイト単位) を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

FltQueryQuotaInformationFile は 、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターン コード 説明
STATUS_FLT_DELETING_OBJECT
 インスタンスまたはボリュームが破棄されています。 これはエラー コードです。

要件

要件 値
サポートされている最小のクライアント Windows 8以降で使用できます。
対象プラットフォーム ユニバーサル
Header fltkernel.h (Fltkernel.h を含む)
Library FltMgr.lib
[DLL] Fltmgr.sys
IRQL PASSIVE_LEVEL

こちらもご覧ください

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile