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

有关更多兼容性信息,请参见“简介”中的兼容性

.NET Framework 等效项

请参见

参考

文件处理

_chsize

_close

_creat、_wcreat

_open、_wopen