_chsize_s
파일 크기를 변경합니다. 이 함수는 CRT의 _chsize
보안 기능에 설명된 대로 보안 기능이 향상된 버전입니다.
구문
errno_t _chsize_s(
int fd,
__int64 size
);
매개 변수
fd
열려 있는 파일을 참조하는 파일 설명자입니다.
size
파일의 새 길이(바이트)입니다.
반환 값
파일 크기가 제대로 변경되면 _chsize_s
는 값 0을 반환합니다. 0이 아닌 반환 값은 오류를 나타냅니다. 반환 값은 각각, 지정된 파일이 액세스에 대해 잠긴 경우 EACCES
, 지정된 파일이 읽기 전용이거나 설명자가 올바르지 않은 경우 EBADF
, 디바이스에 남아 있는 공간이 없는 경우 ENOSPC
또는 크기가 0보다 작은 경우 EINVAL
입니다. errno
는 동일한 값으로 설정됩니다.
이러한 코드 및 기타 반환 코드에 대한 자세한 내용은 , _doserrno
및 _sys_nerr
_sys_errlist
를 참조하세요.errno
설명
_chsize_s
함수는 fd
와 연결된 파일을 size
로 지정된 길이까지 확장하거나 자릅니다. 파일은 쓰기를 허용하는 모드로 열려 있어야 합니다. 파일이 확장되는 경우 Null 문자('\0')가 추가됩니다. 파일이 잘린 경우 짧아진 파일의 끝부터 파일의 원래 길이까지의 모든 데이터가 손실됩니다.
_chsize_s
는 파일 크기로 64비트 정수를 사용하므로 4GB보다 큰 파일 크기를 처리할 수 있습니다. _chsize
는 32비트 파일 크기로 제한됩니다.
이 함수는 해당 매개 변수의 유효성을 검사합니다. 유효한 파일 설명자가 아니거나 크기가 0보다 작은 경우 fd
매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다.
기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.
요구 사항
루틴에서 반환된 값 | 필수 헤더 | 선택적 헤더 |
---|---|---|
_chsize_s |
<io.h> | <errno.h> |
호환성에 대한 자세한 내용은 호환성을 참조하세요.