WIN32_FIND_DATA (FindFirstFile 함수 또는 FindNextFile 함수로 검색된 파일의 정보가 격납)

WIN32_FIND_DATA

FindFirstFile 함수 또는 FindNextFile 함수로 검색된 파일의 정보가 격납됩니다.

#define  MAX_PATH           260

typedef struct _WIN32_FIND_DATA {
    DWORD  dwFileAttributes;       // 속성
    FILETIME  ftCreateTime;        // 작성 일시
    FILETIME  ftLastAccessTime;    // 최종 액세스 일시
    FILETIME  ftLastWriteTime;     // 최종 갱신 일시
    DWORD  nFileSizeHigh;          // 파일 사이즈(상위32비트)
    DWORD  nFileSizeLow;           // 파일 사이즈(하위32비트)
    DWORD  dwReserved0;            // 리파스타그
    DWORD  dwReserved1;            // 예약
    TCHAR  cFileName[MAX_PATH];    // 파일명
    TCHAR  cAlternateFileName[14]; // 8.3형식의 파일명
} WIN32_FIND_DATA, *PWIN32_FIND_DATA, *LPWIN32_FIND_DATA;

멤버

dwFileAttributes

검색된 파일의 속성이 격납됩니다.이하의 값의 편성이 됩니다.

치	의미
0x00000001 (FILE_ATTRIBUTE_READONLY)	독해 전용 속성을 가집니다.이 속성을 가지는 파일은 읽어들일 수 있습니다만 쓰거나 삭제하거나 할 수 없습니다.이 속성을 가지는 디렉토리를 삭제할 수 없습니다.
0x00000002 (FILE_ATTRIBUTE_HIDDEN)	은폐 파일 속성을 가집니다.
0x00000004 (FILE_ATTRIBUTE_SYSTEM)	시스템 속성을 가집니다.
0x00000010 (FILE_ATTRIBUTE_DIRECTORY)	디렉토리입니다.
0x00000020 (FILE_ATTRIBUTE_ARCHIVE)	archiver 속성을 가집니다.
0x00000040 (FILE_ATTRIBUTE_ENCRYPTED)	암호화 속성을 가집니다.이 속성을 가지는 파일은 데이터가 암호화되고 있는 것을 나타냅니다.이 속성을 가지는 디렉토리는, 이 디렉토리안에 새롭게 작성되는 파일이나 서브 디렉토리가 디폴트로 암호화 속성을 가지는 것을 나타냅니다.
0x00000080 (FILE_ATTRIBUTE_NORMAL)	다른 어느 속성도 설정되어 있지 않습니다.
0x00000100 (FILE_ATTRIBUTE_TEMPORARY)	일시 기억 영역으로서 이용되고 있는 파일입니다.
0x00000200 (FILE_ATTRIBUTE_SPARSE_FILE)	스파스파일입니다.
0x00000400 (FILE_ATTRIBUTE_REPARSE_POINT)	관련지을 수 있었던 리파스포인트를 가집니다.
0x00000800 (FILE_ATTRIBUTE_COMPRESSED)	압축 속성을 가집니다.이 속성을 가지는 파일은 데이터가 압축되고 있는 것을 나타냅니다.이 속성을 가지는 디렉토리는, 이 디렉토리안에 새롭게 작성되는 파일이나 서브 디렉토리가 디폴트로 압축 속성을 가지는 것을 나타냅니다.
0x00001000 (FILE_ATTRIBUTE_OFFLINE)	파일은 직접 이용할 수 없습니다.이 속성은, 파일이 오프 라인 스토리지에 이동된 것인 것을 나타냅니다.어플리케이션은 이 속성을 변경해야 하는 것이 아닙니다.

ftCreateTime, ftLastAccessTime, ftLastWriteTime

각각 작성 일시, 최종 액세스 일시, 최종 갱신 일시가 격납되었다 FILETIME 구조체입니다.이것들은 세계 표준시의 형식에서 주어집니다.파일 시스템이 작성 일시, 최종 액세스 일시, 최종 갱신 일시를 서포트하고 있지 않는 경우는, 대응하는 멤버에 0 하지만 격납됩니다.

nFileSizeHigh, nFileSizeLow

아르바이트 단위로 나타난 파일 사이즈의 상위32비트와 하위32비트의 값이 각각 격납됩니다.

dwReserved0

dwFileAttributes 멤버에 FILE_ATTRIBUTE_REPARSE_POINT 속성이 포함되는 경우는, 리파스타그가 격납됩니다.그 이외의 경우는 0 하지만 격납됩니다.

dwReserved1

장래의 확장을 위해서 예약되고 있습니다.

cFileName

파일명을 나타내는 눌 종단 문자열이 격납됩니다.

cAlternateFileName

DOS형식(8.3형식)의 파일명을 나타내는 눌 종단 문자열이 격납됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후

변수와의 대응 (ANSI 판의 경우)

HSP 변수	멤버
	멤버명		오프셋	사이즈
finddata.0	dwFileAttributes		0	4
finddata.1	ftCreateTime	dwLowDateTime	4	4
finddata.2		dwHighDateTime	8	4
finddata.3	ftLastAccessTime	dwLowDateTime	12	4
finddata.4		dwHighDateTime	16	4
finddata.5	ftLastWriteTime	dwLowDateTime	20	4
finddata.6		dwHighDateTime	24	4
finddata.7	nFileSizeHigh		28	4
finddata.8	nFileSizeLow		32	4
finddata.9	dwReserved0		36	4
finddata.10	dwReserved1		40	4
finddata.11	cFileName		44	260
…
finddata.75
finddata.76	cAlternateFileName		304	14 (16)
…
finddata.79