NtSetQuotaInformationFile 함수(ntifs.h)

아티클
02/07/2025

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 필드에는 목록에 있는 다음 할당량 항목의 오프셋(바이트)이 포함됩니다. 현재 항목 이후에 더 이상 항목이 없으면 이 멤버는 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")을 사용해야 합니다.

커널 모드 드라이버의 호출의 경우 NtXxx 및 ZwXxx 버전의 Windows Native System Services 루틴은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. NtXxxZwXxx 루틴 버전 간의 관계에 대한 자세한 내용은 네이티브 시스템 서비스 루틴 Nt 및 Zw 버전 사용참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 7
대상 플랫폼	보편적
헤더	ntifs.h(Ntifs.h, FltKernel.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs, PowerIrpDDis