GetFileSize

GetFileSize

지정된 파일의 사이즈를 취득합니다.

DWORD GetFileSize(
    HANDLE hFile,          // 파일 핸들
    PDWORD pFileSizeHigh   // 상위32비트를 격납하는 변수
);

KERNEL32.DLL

인수

hFile

사이즈를 취득하는 파일의 핸들을 지정합니다.이 핸들은, GENERIC_READ 액세스 또는 GENERIC_WRITE 액세스의 적어도 한편을 지정해 작성된 파일 오브젝트의 것이 아니면 안됩니다.

pFileSizeHigh

파일 사이즈의 상위32비트를 격납하는 변수의 주소를 지정합니다.이 파라미터에 0 (NULL) (을)를 지정했을 경우는, 파일 사이즈의 상위32비트는 취득되지 않습니다.

반환값

성공하면, 파일 사이즈의 하위32비트가 돌아갑니다.또, pFileSizeHigh 파라미터에 유효한 변수의 주소가 지정되어 있는 경우에는, 그 변수에 파일 사이즈의 상위32비트가 돌아갑니다.

pFileSizeHigh 파라미터에 0 (NULL) (을)를 지정했을 때에 함수가 실패하면, 0xFFFFFFFF (INVALID_FILE_SIZE) 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

pFileSizeHigh 파라미터에 0 (NULL) 이외의 값을 지정했을 때에 함수가 실패하면, 0xFFFFFFFF (INVALID_FILE_SIZE) 하지만 돌아가, GetLastError 함수가 0 (NO_ERROR) 이외의 값을 돌려줍니다.

해설

이 함수에, 파이프나 커뮤니케이션 디바이스등의 비시크 디바이스의 핸들을 지정할 수 없습니다.파일 핸들의 파일 타입을 취득하려면 , GetFileType 함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후