GetFileSizeEx 함수(fileapi.h)

지정된 파일의 크기를 검색합니다.

구문

BOOL GetFileSizeEx(
  [in]  HANDLE         hFile,
  [out] PLARGE_INTEGER lpFileSize
);

매개 변수

[in] hFile

파일에 대한 핸들입니다. 핸들은 FILE_READ_ATTRIBUTES 액세스 권한 또는 동등한 권한으로 만들어졌거나 호출자에게 파일이 포함된 디렉터리에 대한 충분한 권한이 있어야 합니다. 자세한 내용은 파일 보안 및 액세스 권한을 참조하세요.

[out] lpFileSize

파일 크기(바이트)를 수신하는 LARGE_INTEGER 구조체에 대한 포인터입니다.

반환 값

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

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

설명

거래된 작업: 파일 핸들에 바인딩된 트랜잭션이 있는 경우 함수는 격리된 파일 뷰에 대한 정보를 반환합니다.

Windows 스토어 앱: GetFileSizeEx 는 지원되지 않습니다. GetFileInformationByHandleEx를 사용합니다.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

기술	지원됨
SMB(서버 메시지 블록) 3.0 프로토콜	Yes
SMB 3.0 TFO(투명 장애 조치(failover))	Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0	Yes
CsvFS(클러스터 공유 볼륨 파일 시스템)	Yes
ReFS(Resilient File System)	Yes

요구 사항

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

참고 항목

파일 관리 함수

LARGE_INTEGER