_chsize_s
更改文件的大小。 _chsizeCRT 中的安全功能所述)。
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的指定长度。 文件绑定中打开允许写入的模式。 null 字符 (“\ 0 ") 追加,如果文件是扩展。 如果文件被截断,缩短从文件的结尾的所有数据。文件的原始长度的丢失。
_chsize_s 大于 4 GB 一个 64 位整数作为文件的大小,并可以处理大文件大小。 _chsize 仅限于 32 位文件大小。
此函数验证其参数。 如果 fd 不是一个有效的文件说明符或范围小于零,无效参数处理程序,如 参数验证所述。
要求
例程 |
必需的标头 |
可选标头 |
---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
有关更多兼容性信息,请参见“简介”中的兼容性。