파일 특성 상수

파일 특성은 디스크의 파일 시스템에 의해 저장된 메타데이터 값이며 시스템에서 사용되며 다양한 파일 I/O API를 통해 개발자가 사용할 수 있습니다. 관련 API 및 항목 목록은 참고 섹션을 참조하세요.

예제



FILE_BASIC_INFO basicInfo;
    BOOL result;

    result = GetFileInformationByHandleEx( hFile,
                                               FileBasicInfo,
                                               &basicInfo,
                                               sizeof(basicInfo));

\\...

printf("  File Attributes: ");
    PrintFileAttributes(basicInfo.FileAttributes);

\\...
VOID
PrintFileAttributes(
    ULONG FileAttributes
    )
{
    
    if (FileAttributes & FILE_ATTRIBUTE_ARCHIVE) {
        printf("Archive ");
    }
    if (FileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
        printf("Directory ");
    }
    if (FileAttributes & FILE_ATTRIBUTE_READONLY) {
        printf("Read-Only ");
    }
}

GitHub의 Windows 클래식 샘플 에서 가져온 예제입니다.

상수/값 설명
FILE_ATTRIBUTE_ARCHIVE
32(0x20)
보관 파일 또는 디렉터리인 파일 또는 디렉터리입니다. 애플리케이션은 일반적으로 이 특성을 사용하여 백업 또는 제거를 위해 파일을 표시합니다.
FILE_ATTRIBUTE_COMPRESSED
2048년(0x800)
압축된 파일 또는 디렉터리입니다. 파일의 경우 파일의 모든 데이터가 압축됩니다. 디렉터리의 경우 새로 만든 파일 및 하위 디렉터리의 기본값은 압축입니다.
FILE_ATTRIBUTE_DEVICE
64(0x40)
이 값은 시스템 사용을 위해 예약되어 있습니다.
FILE_ATTRIBUTE_DIRECTORY
16(0x10)
디렉터리를 식별하는 핸들입니다.
FILE_ATTRIBUTE_ENCRYPTED
16384 (0x4000)
암호화된 파일 또는 디렉터리입니다. 파일의 경우 파일의 모든 데이터 스트림이 암호화됩니다. 디렉터리의 경우 새로 만든 파일 및 하위 디렉터리의 기본값은 암호화입니다.
FILE_ATTRIBUTE_HIDDEN
2(0x2)
파일 또는 디렉터리가 숨겨집니다. 일반 디렉터리 목록에는 포함되지 않습니다.
FILE_ATTRIBUTE_INTEGRITY_STREAM
32768 (0x8000)
디렉터리 또는 사용자 데이터 스트림은 무결성으로 구성됩니다(ReFS 볼륨에서만 지원됨). 일반 디렉터리 목록에는 포함되지 않습니다. 무결성 설정은 이름이 바뀐 경우 파일과 함께 유지됩니다. 파일이 복사되면 원본 파일 또는 대상 디렉터리에 무결성이 설정된 경우 대상 파일의 무결성이 설정됩니다.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 Windows Server 2012까지 지원되지 않습니다.
FILE_ATTRIBUTE_NORMAL
128 (0x80)
다른 특성이 설정되지 않은 파일입니다. 이 특성은 단독으로 사용하는 경우에만 유효합니다.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
8192 (0x2000)
파일 또는 디렉터리를 콘텐츠 인덱싱 서비스에서 인덱싱할 수 없습니다.
FILE_ATTRIBUTE_NO_SCRUB_DATA
131072(0x20000)
백그라운드 데이터 무결성 스캐너(AKA 스크러버)에서 읽을 수 없는 사용자 데이터 스트림입니다. 디렉터리에 설정된 경우 상속만 제공합니다. 이 플래그는 스토리지 공간 및 ReFS 볼륨에서만 지원됩니다. 일반 디렉터리 목록에는 포함되지 않습니다.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 Windows 8 및 Windows Server 2012까지 지원되지 않습니다.
FILE_ATTRIBUTE_OFFLINE
4096 (0x1000)
파일의 데이터를 즉시 사용할 수 없습니다. 이 특성은 파일 데이터가 오프라인 스토리지로 물리적으로 이동되었음을 나타냅니다. 이 특성은 계층적 스토리지 관리 소프트웨어인 Remote Storage에서 사용됩니다. 애플리케이션은 이 특성을 임의로 변경해서는 안 됩니다.
FILE_ATTRIBUTE_READONLY
1(0x1)
읽기 전용인 파일입니다. 애플리케이션은 파일을 읽을 수 있지만 파일을 쓰거나 삭제할 수는 없습니다. 이 특성은 디렉터리에서 적용되지 않습니다. 자세한 내용은 Windows Server 2003, Windows XP, Windows Vista 또는 Windows 7에서 읽기 전용 또는 폴더의 시스템 특성을 보거나 변경할 수 없음을 참조하세요.
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS
4194304(0x400000)
이 특성이 설정되면 파일 또는 디렉터리가 로컬에 완전히 존재하지 않음을 의미합니다. 모든 데이터가 로컬 스토리지에 있는 것은 아니라는 것을 의미하는 파일의 경우(예: 원격 스토리지에 있는 일부 데이터와 스파스일 수 있음) 디렉터리의 경우 디렉터리 콘텐츠 중 일부가 다른 위치에서 가상화되고 있음을 의미합니다. 파일을 읽거나 디렉터리를 열거하는 경우 평소보다 비용이 많이 듭니다. 예를 들어 원격 저장소에서 파일/디렉터리 콘텐츠 중 적어도 일부를 페치합니다. 커널 모드 호출자만 이 비트를 설정할 수 있습니다.
FILE_ATTRIBUTE_RECALL_ON_OPEN
262144(0x40000)
이 특성은 디렉터리 열거형 클래스(FILE_DIRECTORY_INFORMATION, FILE_BOTH_DIR_INFORMATION 등)에만 나타납니다. 이 특성이 설정되면 파일 또는 디렉터리에 로컬 시스템에 대한 실제 표현이 없음을 의미합니다. 항목이 가상입니다. 항목을 열면 평소보다 비용이 많이 듭니다. 예를 들어 일부 항목은 원격 저장소에서 인출됩니다.
FILE_ATTRIBUTE_REPARSE_POINT
1024년(0x400)
연결된 재문 분석 지점이 있는 파일 또는 디렉터리 또는 기호 링크인 파일입니다.
FILE_ATTRIBUTE_SPARSE_FILE
512 (0x200)
스파스 파일인 파일입니다.
FILE_ATTRIBUTE_SYSTEM
4(0x4)
운영 체제에서 일부 또는 단독으로 사용하는 파일 또는 디렉터리입니다.
FILE_ATTRIBUTE_TEMPORARY
256 (0x100)
임시 스토리지에 사용되는 파일입니다. 일반적으로 애플리케이션은 핸들이 닫힌 후 임시 파일을 삭제하므로 충분한 캐시 메모리를 사용할 수 있는 경우 파일 시스템은 대량 스토리지에 데이터를 다시 쓰지 않습니다. 이 시나리오에서 시스템은 데이터 쓰기를 완전히 방지할 수 있습니다. 그렇지 않으면 핸들이 닫힌 후 데이터가 기록됩니다.
FILE_ATTRIBUTE_VIRTUAL
65536 (0x10000)
이 값은 시스템 사용을 위해 예약되어 있습니다.
FILE_ATTRIBUTE_PINNED
524288(0x80000)
이 특성은 적극적으로 액세스하지 않는 경우에도 파일 또는 디렉터리를 로컬로 완전히 유지해야 한다는 사용자 의도를 나타냅니다. 이 특성은 계층적 스토리지 관리 소프트웨어에서 사용하기 위한 것입니다.
FILE_ATTRIBUTE_UNPINNED
1048576(0x100000)
이 특성은 적극적으로 액세스하는 경우를 제외하고 파일 또는 디렉터리를 로컬로 완전히 유지하면 안 됨을 나타냅니다. 이 특성은 계층적 스토리지 관리 소프트웨어에서 사용하기 위한 것입니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2003 [데스크톱 앱만 해당]
헤더
WinNT.h(Windows.h 포함)

참고 항목

압축 특성

파일 만들기 및 열기

CreateFile

CreateFileTransacted

GetFileAttributes

GetFileAttributesEx

GetFileAttributesTransacted

GetFileInformationByHandle

GetFileInformationByHandleEx

SetFileAttributes

SetFileAttributesTransacted

SetFileInformationByHandle