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에서 이 함수는 다음 기술을 통해 지원됩니다.