次の方法で共有


NtSetQuotaInformationFile 関数 (ntifs.h)

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

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetQuotaInformationFile(
  [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

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

戻り値

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

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

注釈

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

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

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

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

注意

NtSetQuotaInformationFile 関数の呼び出しがカーネル モードで発生する場合は、"NtSetQuotaInformationFile" ではなく"[ZwSetQuotaInformationFile](nf-ntifs-zwsetquotainformationfile.md" という名前を使用する必要があります。

カーネル モード ドライバーからの呼び出しの場合、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、PowerIrpDDis

こちらもご覧ください

FILE_GET_QUOTA_INFORMATION

FILE_QUOTA_INFORMATION

IO_STATUS_BLOCK

IRP_MJ_QUERY_QUOTA

IRP_MJ_SET_QUOTA

IoCheckQuotaBufferValidity

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

NtQueryQuotaInformationFile