NtSetQuotaInformationFile 函数 (ntifs.h)

项目
02/26/2024

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

包含应应用于卷的新配额条目的缓冲区。配额信息的格式必须设置为一个或多个 FILE_QUOTA_INFORMATION 结构。 FILE_QUOTA_INFORMATION 结构中的 NextEntryOffset 字段包含列表中下一个配额条目的偏移量（以字节为单位）。如果当前条目之后没有其他条目，则此成员为零。

[in] Length

缓冲区的长度（以字节为单位）。

返回值

NtSetQuotaInformationFile 例程返回STATUS_SUCCESS或相应的 NTSTATUS 值，如以下值之一：

返回代码	说明
STATUS_INSUFFICIENT_RESOURCES	资源不足，无法完成操作。这是错误代码。
STATUS_INVALID_DEVICE_REQUEST	卷上未启用配额。这是错误代码。
STATUS_MEDIA_WRITE_PROTECTED	卷是只读的。这是错误代码。

注解

NtSetQuotaInformationFile 例程将指定 Buffer 参数中的所有配额条目应用于卷。

IoCheckQuotaBufferValidity 函数可以检查作为 Buffer 参数传递的指定配额缓冲区是否有效。

调用 NtSetQuotaInformationFile 将导致 将IRP_MJ_SET_QUOTA 请求发送到与文件对象关联的设备对象，该文件对象的句柄存储在 FileHandle 参数中。

如果基础文件系统不支持 FAT 和 CDFS 文件系统 (配额信息（例如) ）， NtSetQuotaInformationFile 将无法返回STATUS_INVALID_DEVICE_REQUEST。

注意

如果对 NtSetQuotaInformationFile 函数的调用在内核模式下发生，则应使用名称“[ZwSetQuotaInformationFile] (nf-ntifs-zwsetquotainformationfile.md”而不是“NtSetQuotaInformationFile”。

对于来自内核模式驱动程序的调用，Windows 本机系统服务例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅使用本机系统服务例程的 Nt 和 Zw 版本。

要求

要求	值
最低受支持的客户端	Windows 7
目标平台	通用
标头	ntifs.h (包括 Ntifs.h、FltKernel.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI，PowerIrpDDis