GetFileTime 함수(fileapi.h)

아티클
08/23/2023

파일 또는 디렉터리를 만들고, 마지막으로 액세스하고, 마지막으로 수정한 날짜와 시간을 검색합니다.

구문

BOOL GetFileTime(
  [in]            HANDLE     hFile,
  [out, optional] LPFILETIME lpCreationTime,
  [out, optional] LPFILETIME lpLastAccessTime,
  [out, optional] LPFILETIME lpLastWriteTime
);

매개 변수

[in] hFile

날짜 및 시간을 검색할 파일 또는 디렉터리에 대한 핸들입니다. GENERIC_READ 액세스 권한이 있는 CreateFile 함수를 사용하여 핸들을 만들어야 합니다. 자세한 내용은 파일 보안 및 액세스 권한을 참조하세요.

[out, optional] lpCreationTime

파일 또는 디렉터리를 만든 날짜와 시간을 수신하는 FILETIME 구조체에 대한 포인터입니다. 애플리케이션에 이 정보가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

[out, optional] lpLastAccessTime

파일 또는 디렉터리에 마지막으로 액세스한 날짜와 시간을 수신하는 FILETIME 구조체에 대한 포인터입니다. 마지막 액세스 시간에는 파일 또는 디렉터리가 기록되거나, 읽거나, 실행 파일의 경우 마지막으로 실행된 시간이 포함됩니다. 애플리케이션에 이 정보가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

[out, optional] lpLastWriteTime

파일 또는 디렉터리가 마지막으로 쓰여졌거나, 잘리거나, 덮어쓴 날짜 및 시간을 수신하는 FILETIME 구조체에 대한 포인터입니다(예: WriteFile 또는 SetEndOfFile 사용). 파일 특성 또는 보안 설명자가 변경되면 이 날짜와 시간이 업데이트되지 않습니다. 애플리케이션에 이 정보가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

모든 파일 시스템에서 생성 및 마지막 액세스 시간을 기록할 수 있는 것은 아니며, 모든 파일 시스템에서 동일한 방식으로 기록하는 것은 아닙니다. 예를 들어 FAT에서 만들기 시간은 해상도가 10밀리초이고, 쓰기 시간은 해상도가 2초이고, 액세스 시간은 1일(실제로 액세스 날짜)의 해상도를 가집니다. 따라서 GetFileTime 함수는 SetFileTime 함수를 사용하여 설정된 동일한 파일 시간 정보를 반환하지 않을 수 있습니다.

NTFS는 마지막 액세스 후 최대 1시간까지 파일의 마지막 액세스 시간으로 업데이트를 지연합니다. 또한 NTFS는 마지막 액세스 시간 업데이트를 사용하지 않도록 설정할 수 있도록 허용합니다. 마지막 액세스 시간은 기본적으로 NTFS 볼륨에서 업데이트되지 않습니다.

Windows Server 2003 및 Windows XP: 마지막 액세스 시간은 기본적으로 NTFS 볼륨에서 업데이트됩니다.

자세한 내용은 파일 시간을 참조하세요.

파일 이름을 바꾸거나 삭제한 후 곧 복원하면 Windows는 캐시에서 복원할 파일 정보를 검색합니다. 캐시된 정보에는 짧은/긴 이름 쌍 및 생성 시간이 포함됩니다.

예제

예제는 Last-Write 시간 검색을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	fileapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll