FILE_FS_CONTROL_INFORMATION 구조체(ntifs.h)

아티클
02/26/2024

FILE_FS_CONTROL_INFORMATION 구조는 디렉터리의 파일에 대한 제어 정보를 쿼리하거나 설정하는 데 사용됩니다.

구문

typedef struct _FILE_FS_CONTROL_INFORMATION {
  LARGE_INTEGER FreeSpaceStartFiltering;
  LARGE_INTEGER FreeSpaceThreshold;
  LARGE_INTEGER FreeSpaceStopFiltering;
  LARGE_INTEGER DefaultQuotaThreshold;
  LARGE_INTEGER DefaultQuotaLimit;
  ULONG         FileSystemControlFlags;
} FILE_FS_CONTROL_INFORMATION, *PFILE_FS_CONTROL_INFORMATION;

멤버

FreeSpaceStartFiltering

콘텐츠 인덱싱 디먼이 문서 필터링을 시작하는 데 필요한 최소 사용 가능한 디스크 공간(바이트)입니다.

FreeSpaceThreshold

인덱싱 서비스에서 문서를 계속 필터링하고 단어 목록을 병합하는 데 필요한 최소 사용 가능한 디스크 공간(바이트)입니다. 사용 가능한 디스크 공간의 양이 이 임계값보다 낮으면 Microsoft Windows 애플리케이션 이벤트 로그에 경고 메시지가 기록됩니다. 필터링 및 병합은 공간이 해제될 때까지 중지됩니다.

FreeSpaceStopFiltering

콘텐츠 인덱싱 디먼이 문서 필터링을 계속하는 데 필요한 최소 사용 가능한 디스크 공간(바이트)입니다. 사용 가능한 디스크 공간의 양이 이 임계값보다 낮으면 문서 필터링이 중지됩니다.

DefaultQuotaThreshold

볼륨에 대한 기본 사용자별 디스크 할당량 경고 임계값입니다.

DefaultQuotaLimit

볼륨에 대한 기본 사용자별 디스크 할당량 제한입니다.

FileSystemControlFlags

볼륨에서 사용자 관련 할당량 이벤트의 할당량 적용 및 로깅을 제어하는 플래그의 비트 마스크입니다. 로깅은 Windows 애플리케이션 이벤트 로그에 항목을 만듭니다. 다음 중 하나 이상의 호환 가능한 조합:

파일 시스템 제어 플래그	의미
FILE_VC_CONTENT_INDEX_DISABLED	설정하면 콘텐츠 인덱싱이 비활성화됩니다.
FILE_VC_LOG_QUOTA_LIMIT	설정된 경우 사용자가 할당된 디스크 할당량 한도를 초과하면 이벤트 로그 항목이 만들어집니다.
FILE_VC_LOG_QUOTA_THRESHOLD	설정된 경우 사용자가 할당된 할당량 경고 임계값을 초과하면 이벤트 로그 항목이 만들어집니다.
FILE_VC_LOG_VOLUME_LIMIT	설정되면 볼륨의 사용 가능한 공간 제한을 초과하면 이벤트 로그 항목이 만들어집니다.
FILE_VC_LOG_VOLUME_THRESHOLD	설정되면 볼륨의 사용 가능한 공간 임계값을 초과하면 이벤트 로그 항목이 만들어집니다.
FILE_VC_QUOTA_ENFORCE	설정되면 할당량이 볼륨에 적용됩니다.
FILE_VC_QUOTA_TRACK	설정된 경우 할당량은 볼륨에서 추적됩니다.
FILE_VC_QUOTAS_INCOMPLETE	설정하면 볼륨에 대한 할당량 정보가 불완전합니다.
FILE_VC_QUOTAS_REBUILDING	설정된 경우 파일 시스템은 볼륨에 대한 할당량 정보를 다시 빌드합니다.

또한 다음 플래그 마스크가 정의됩니다. 플래그 값을 테스트하는 데 유용합니다.

Mask	값
FILE_VC_QUOTA_MASK	FILE_VC_QUOTA_ENFORCE \| FILE_VC_QUOTA_TRACK
FILE_VC_QUOTA_NONE	~FILE_VC_QUOTA_ENFORCE & ~FILE_VC_QUOTA_TRACK
FILE_VC_VALID_MASK	위의 표에 있는 모든 플래그의 ORed 조합입니다.

설명

이 정보는 다음 방법 중 하나로 쿼리할 수 있습니다.

FltQueryVolumeInformation 또는 ZwQueryVolumeInformationFile을 호출하여 FileFsControlInformation을 FileInformationClass 값으로 전달하고 호출자가 할당한 FILE_FS_CONTROL_INFORMATION 구조화된 버퍼를 FileInformation 값으로 전달합니다.
주 함수 코드 IRP_MJ_QUERY_VOLUME_INFORMATION 사용하여 IRP를 만듭니다.

이 정보를 쿼리하려면 볼륨에 대한 FILE_READ_DATA 액세스가 필요합니다.

이 정보는 다음 방법 중 하나로 설정할 수 있습니다.

FltSetVolumeInformation 또는 ZwSetVolumeInformationFile을 호출하여 FileFsControlInformation을 FileInformationClass 값으로 전달하고 호출자가 할당한 FILE_FS_CONTROL_INFORMATION 구조화된 버퍼를 FileInformation 값으로 전달합니다.
주 함수 코드 IRP_MJ_SET_VOLUME_INFORMATION 사용하여 IRP를 만듭니다.

이 정보를 설정하려면 볼륨에 대한 FILE_WRITE_DATA 액세스가 필요합니다.

FileInformation 매개 변수에서 FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile 또는 ZwSetVolumeInformationFile에 전달된 버퍼의 크기는 최소 sizeof(FILE_FS_CONTROL_INFORMATION)여야 합니다.

이 구조체는 LONGLONG(8 바이트) 경계에 맞춰야 합니다.