_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>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

참고 항목

파일 처리
_chsize
_close
_creat, _wcreat
_open, _wopen