_chsize_s

아티클
06/09/2015

파일 크기를 수정합니다. CRT의 보안 기능 에 설명된 대로 이 버전은 보안 향상 기능이 포함된 _chsize 의 버전입니다.

errno_t _chsize_s( 
   int fd,
   __int64 size 
);

매개 변수

fd
열려 있는 파일을 나타내는 파일 설명자입니다.
size
새 파일의 길이(바이트)입니다.

반환 값

만일 파일의 크기가 성공적으로 변경되면, _chsize_s 은 0을 반환합니다. 오류는 0이 아닌 반환값을 나타냅니다: 만일 지정된 파일이 접근에 대하여 허가되지 않은 경우, 반환값은 EACCES 이고, 만일 지정된 파일이 읽기 전용이거나 설명자가 잘못된 경우, EBADF , 만일 장치에 공간이 없는 경우, ENOSPC 로, 크기가 0보다 적은 경우, EINVAL 을 반환합니다. errno 같은 값으로 설정합니다.

이러한 반환 코드 및 기타 반환 코드에 대한 자세한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr을 참조하십시오.

설명

_chsize_s 함수는 size 로 지정된 길이로 fd 를 사용하여 파일을 자르거나 확장합니다. 파일은 쓰기를 허용 하는 모드에서 열려 있어야 합니다. 파일이 확장되는 경우, null 문자('\0')이 추가됩니다. 파일이 잘린경우, 파일의 본래 길이로 단축된 파일의 끝으로부터 모든 데이터가 손실됩니다.

_chsize_s 은 파일 크기로 64 비트 정수를 사용하고, 따라서 4GB 보다 큰 파일 크기를 처리할 수 있습니다. _chsize 은 32 비트 파일로 크기가 제한됩니다.

이 함수는 해당 매개 변수의 유효성을 검사합니다. 만일 fd 이 유효한 파일 설명자가 아니거나 0보다 적은 크기를 가지는 경우 매개 변수 유효성 검사 에 설명된 대로 잘못된 매개변수 처리기를 호출합니다.