_chsize_s
Изменяет размер файла. Это версия _chsize с усовершенствованиями безопасности, как описано в Функции безопасности в CRT.
errno_t _chsize_s(
int fd,
__int64 size
);
Параметры
fd
Идентификатор файла, ссылающийся на открытый файл.size
Новая длина файла в байтах.
Возвращаемое значение
_chsize_s возвращает значение 0, если размер файла успешно изменен. Возвращаемое ненулевое значение указывает на ошибку: возвращаемое значение равно EACCES , если указанный файл блокирован для доступа, EBADF , если указанный файл доступен только для чтения или дескриптор недопустим, ENOSPC , если отсутствует свободное место на устройстве, или EINVAL , если размер меньше нуля. errno устанавливает в то же значение.
Дополнительные сведения об этих и других кодах возврата см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.
Заметки
Функция _chsize_s расширяет или усекает файл, связанный с fd, до длины, указанной в size. Файл должен быть открыт в режиме, который позволяет запись. В файл добавляются нуль-символы ('\0'), если файл расширяется. Если файл усекается, все данные от конца сокращенного файла до длины исходного файла теряются.
_chsize_s принимает 64-разрядное целое число в качестве размера файла, и поэтому может обрабатывать файлы, размер которых превосходит 4 ГБ. _chsize ограничена 32-разрядными размерами файлов.
Эта функция проверяет свои параметры. Если fd не является допустимым идентификатором или размер файла меньше нуля, то вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров.
Требования
Подпрограмма |
Обязательный заголовок |
Необязательный заголовок |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.