ZwSetQuotaInformationFile 関数 (ntifs.h)

[アーティクル]
02/26/2024

ZwSetQuotaInformationFile ルーチンは、FileHandle パラメーターに関連付けられているボリュームのクォータエントリを変更します。指定したバッファー内のすべてのクォータエントリがボリュームに適用されます。

構文

NTSYSAPI NTSTATUS ZwSetQuotaInformationFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

パラメーター

[in] FileHandle

クォータ情報を変更するファイルまたはボリュームを表すファイルオブジェクトのハンドル。

[out] IoStatusBlock

呼び出し元の I/O 状態ブロックのアドレス。

[in] Buffer

ボリュームに適用する必要がある新しいクォータエントリを含むバッファー。クォータ情報は、1 つ以上の FILE_QUOTA_INFORMATION 構造体として書式設定する必要があります。 FILE_QUOTA_INFORMATION構造体の NextEntryOffset フィールドには、リスト内の次のクォータエントリのオフセット (バイト単位) が含まれています。現在のエントリの後にエントリが存在しない場合、このメンバーは 0 になります。

[in] Length

バッファーの長さ (バイト単位)。

戻り値

ZwSetQuotaInformationFile ルーチンは、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_INSUFFICIENT_RESOURCES	操作を完了するためのリソースが不足していました。これはエラーコードです。
STATUS_INVALID_DEVICE_REQUEST	ボリュームでクォータが有効になっていません。これはエラーコードです。
STATUS_MEDIA_WRITE_PROTECTED	ボリュームは読み取り専用です。これはエラーコードです。

注釈

ZwSetQuotaInformationFile ルーチンは、指定された Buffer パラメーター内のすべてのクォータエントリをボリュームに適用します。

IoCheckQuotaBufferValidity 関数は、Buffer パラメーターとして渡された指定されたクォータバッファーが有効かどうかをチェックできます。

ZwSetQuotaInformationFile を呼び出すと、ハンドルが FileHandle パラメーターに格納されているファイルオブジェクトに関連付けられているデバイスオブジェクトにIRP_MJ_SET_QUOTA要求が送信されます。

基になるファイルシステムがクォータ情報 (FAT や CDFS ファイルシステムなど) をサポートしていない場合、 ZwSetQuotaInformationFile はSTATUS_INVALID_DEVICE_REQUESTを返しません。

注意

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

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

要件

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