FILE_FS_PERSISTENT_VOLUME_INFORMATION 구조체(ntifs.h)

FILE_FS_PERSISTENT_VOLUME_INFORMATION 구조체는 파일 시스템 볼륨에 대한 영구 설정을 제어하는 데 사용됩니다. 영구 설정은 컴퓨터를 다시 부팅하는 동안 파일 시스템 볼륨에서 유지됩니다.

구문

typedef struct _FILE_FS_PERSISTENT_VOLUME_INFORMATION {
  ULONG VolumeFlags;
  ULONG FlagMask;
  ULONG Version;
  ULONG Reserved;
} FILE_FS_PERSISTENT_VOLUME_INFORMATION, *PFILE_FS_PERSISTENT_VOLUME_INFORMATION;

구성원

VolumeFlags

파일 시스템 볼륨에 대한 영구 상태 설정입니다. 이 값은 다음의 비트 OR 조합입니다.

값	의미
PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 0x00000001	이 비트에 대해 0은 8.3 짧은 이름을 만들 수 있음을 나타내고, 1은 짧은 이름 만들기를 사용할 수 없음을 나타냅니다. 8.3 짧은 파일 이름에는 최대 8자, 마침표 "." 및 최대 3자의 파일 이름 확장명이 있습니다.
PERSISTENT_VOLUME_STATE_VOLUME_SCRUB_DISABLED 0x00000002	설정하면 이 플래그는 볼륨에 대해 볼륨 스크럽이 비활성화되었음을 나타냅니다. 이 플래그는 Windows 8 시작해도 유효합니다.
PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY 0x00000004	계층화된 볼륨에 대해 전역 검색 페널티가 사용되지 않습니다. 이 플래그는 Windows 8.1 시작해도 유효합니다.
PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY 0x00000008	계층화된 볼륨에 대해 로컬 검색 페널티가 활성화되지 않습니다. 이 플래그는 Windows 8.1 시작해도 유효합니다.
PERSISTENT_VOLUME_STATE_NO_HEAT_GATHERING 0x00000010	설정하면 계층화된 볼륨에 대해 열 수집을 사용할 수 없습니다. 이 플래그는 Windows 8.1 시작해도 유효합니다.
PERSISTENT_VOLUME_STATE_CONTAINS_BACKING_WIM 0x00000020	이 볼륨이 WIM(Windows 이미지 형식) 파일의 파일로 시스템 볼륨을 백업하고 있음을 나타냅니다. 이 플래그는 Windows 8.1 Update 시작해도 유효합니다.
PERSISTENT_VOLUME_STATE_BACKED_BY_WIM 0x00000040	이 볼륨은 시스템 중요 부팅 파일을 제공하기 위해 다른 볼륨에 종속되어 있음을 나타냅니다. 다른 볼륨에는 이 볼륨의 파일을 백업하는 WIM 파일이 포함되어 있습니다. 이 플래그는 읽기 전용입니다. 이 플래그는 Windows 8.1 Update 시작해도 유효합니다.

FlagMask

VolumeFlags에 표시할 수 있는 유효한 플래그에 대한 마스크 값입니다. VolumeFlags에 대해 설명된 원하는 플래그의 비트 OR 조합입니다.

Version

이 구조체의 버전 번호입니다. 1로 설정됩니다.

Reserved

예약되어 있습니다. 0으로 설정;

설명

FILE_FS_PERSISTENT_VOLUME_INFORMATION 구조체는 FSCTL_SET_PERSISTENT_VOLUME_STATE 및 FSCTL_QUERY_PERSISTENT_VOLUME_STATE 제어 코드와 함께 사용됩니다.

상태 플래그를 쿼리하기 위해 FlagMask 는 확인할 플래그의 조합으로 설정됩니다. 예를 들어, 검색 페널티 플래그만 관심 있는 경우 FlagMask = PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY | PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY. 또한 짧은 이름 지원만 쿼리하는 경우 FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 설정합니다.

FSCTL_SET_PERSISTENT_VOLUME_STATE 사용하여 영구 볼륨 상태 플래그를 설정하거나 지울 때 FlagMask는 볼륨에 영향을 받는 VolumeFlags의 모든 플래그로 설정됩니다. VolumeFlags는 볼륨에 대해 설정할 실제 영구 상태 플래그를 포함합니다. 다음 예제에서는 볼륨에 대해 짧은 이름 만들기를 사용하도록 FILE_FS_PERSISTENT_VOLUME_INFORMATION 멤버를 설정하는 방법을 보여 줍니다.

IO_STATUS_BLOCK IoStatus;
FILE_FS_PERSISTENT_VOLUME_INFORMATION PersistVolInfo;
NTSTATUS status;

PersistVolInfo.VolumeFlags = 0;    // enable shortname creation on this volume
PersistVolInfo.FlagMask    = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED;
PersistVolInfo.Version     = 1;
PersistVolInfo.Reserved    = 0;

// issue the request to the file system to set the enable state
//
status = ZwFsControlFile( VolumeHandle,
                          NULL,
                          NULL,
                          NULL,
                          &IoStatus,
                          FSCTL_SET_PERSISTENT_VOLUME_STATE,
                          &PersistVolInfo,
                          sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION),
                          NULL,
                          0 );

버전 멤버는 쿼리 및 집합 요청 모두에 대해 현재 버전 1로 설정해야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7부터 사용할 수 있습니다.
헤더	ntifs.h(Ntifs.h 포함)

참조

FSCTL_QUERY_PERSISTENT_VOLUME_STATE

FSCTL_SET_PERSISTENT_VOLUME_STATE