FILE_FULL_DIR_INFO 구조체(winbase.h)

아티클
08/27/2023

파일에 대한 디렉터리 정보를 포함합니다. FileFullDirectoryInfo 또는 FileFullDirectoryRestartInfo가 FileInformationClass 매개 변수에 전달되면 이 구조체는 GetFileInformationByHandleEx 함수에서 반환됩니다.

구문

typedef struct _FILE_FULL_DIR_INFO {
  ULONG         NextEntryOffset;
  ULONG         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  ULONG         FileAttributes;
  ULONG         FileNameLength;
  ULONG         EaSize;
  WCHAR         FileName[1];
} FILE_FULL_DIR_INFO, *PFILE_FULL_DIR_INFO;

멤버

NextEntryOffset

반환되는 다음 FILE_FULL_DIR_INFO 구조체에 대한 오프셋입니다. 이 항목을 따르는 다른 항목이 없으면 0을 포함합니다.

FileIndex

부모 디렉터리 내 파일의 바이트 오프셋입니다. 이 멤버는 부모 디렉터리 내의 파일 위치가 고정되지 않고 정렬 순서를 유지하기 위해 언제든지 변경할 수 있는 NTFS와 같은 파일 시스템에 대해 정의되지 않습니다.

CreationTime

파일을 만든 시간입니다.

LastAccessTime

파일에 마지막으로 액세스한 시간입니다.

LastWriteTime

파일이 마지막으로 기록된 시간입니다.

ChangeTime

파일이 마지막으로 변경된 시간입니다.

EndOfFile

파일의 시작부터 파일의 기본 데이터 스트림 끝까지의 바이트 오프셋인 절대 새 파일 끝 위치입니다. 이 값은 0부터 시작하므로 실제로 파일의 첫 번째 무료 바이트를 나타냅니다. 즉, EndOfFile 은 파일의 마지막 유효한 바이트 바로 뒤에 있는 바이트에 대한 오프셋입니다.

AllocationSize

파일에 할당된 바이트 수입니다. 이 값은 일반적으로 기본 물리적 디바이스의 섹터 또는 클러스터 크기의 배수입니다.

FileAttributes

파일 특성입니다. 이 멤버는 다음 특성의 유효한 조합일 수 있습니다.

FILE_ATTRIBUTE_ARCHIVE(0x00000020)

FILE_ATTRIBUTE_COMPRESSED(0x00000800)

FILE_ATTRIBUTE_DIRECTORY(0x00000010)

FILE_ATTRIBUTE_HIDDEN(0x00000002)

FILE_ATTRIBUTE_NORMAL(0x00000080)

FILE_ATTRIBUTE_READONLY(0x00000001)

FILE_ATTRIBUTE_SYSTEM(0x00000004)

FILE_ATTRIBUTE_TEMPORARY(0x00000100)

FileNameLength

파일 이름의 길이입니다.

EaSize

파일에 대한 확장 특성의 크기입니다.

FileName[1]

파일 이름 문자열의 첫 번째 문자입니다. 이 뒤에는 나머지 문자열이 메모리에서 수행됩니다.

설명

FILE_FULL_DIR_INFO 구조체는 FILE_ID_BOTH_DIR_INFO 구조체에 있는 정보의 하위 집합입니다. 추가 정보가 필요하지 않은 경우 디렉터리 항목에서 제공되므로 작업이 더 빨라집니다. FILE_ID_BOTH_DIR_INFO 디렉터리 항목과 MFT(마스터 파일 테이블)의 정보를 포함합니다.

이 정보를 쿼리하는 데 특정 액세스 권한이 필요하지 않습니다.

모든 날짜와 시간은 절대 시스템 시간 형식입니다. 절대 시스템 시간은 1601년 초부터 100나노초 간격의 수입니다.

이 FILE_FULL_DIR_INFO 구조체는 LONGLONG (8 바이트) 경계에 맞춰야 합니다. 버퍼에 이러한 구조체가 두 개 이상 포함된 경우 마지막을 제외한 각 항목의 NextEntryOffset 값은 8 바이트 경계에 해당합니다.

이 구조를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 매크로를 0x0600 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
머리글	winbase.h(Windows.h 포함)

추가 정보

FILE_INFO_BY_HANDLE_CLASS

파일 관리 구조

GetFileInformationByHandleEx

다음을 통해 공유