_chsize_s

Cambia el tamaño de un archivo. Esta función es una versión de con mejoras de seguridad, como se describe en Características de _chsize seguridad de CRT.

Sintaxis

errno_t _chsize_s(
   int fd,
   __int64 size
);

Parámetros

fd
Descriptor de archivo que hace referencia a un archivo abierto.

size
Nueva longitud del archivo en bytes.

Valor devuelto

_chsize_s devuelve el valor 0 si el tamaño del archivo se modifica correctamente. Un valor devuelto distinto de cero indica un error: el valor de devuelto es EACCES si el archivo especificado está bloqueado contra el acceso, EBADF si el archivo especificado es de solo lectura o el descriptor no es válido, ENOSPC si no queda espacio en el dispositivo, o EINVAL si el tamaño es menor que cero. errno se establece en el mismo valor.

Para obtener más información sobre estos y otros códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.

Comentarios

La función _chsize_s amplía o trunca el archivo asociado a fd según la longitud que size especifique. El archivo debe estar abierto en un modo que permita escritura. Si el archivo se amplía, se anexan caracteres nulos ("\0"). Si el archivo se trunca, se pierden todos los datos desde el final del archivo abreviado hasta la longitud original del archivo.

_chsize_s toma un entero de 64 bits como tamaño de archivo y, por lo tanto, puede controlar tamaños de archivo de más de 4 GB. _chsize se limita a los tamaños de archivo de 32 bits.

Esta función valida sus parámetros. Si fd no es un descriptor de archivo o un tamaño válidos es menor que cero, se invoca al controlador de parámetros no válidos, como se describe en Validación de parámetros.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario	Encabezado opcional
_chsize_s	<io.h>	<errno.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Consulte también

Control de archivos
_chsize
_close
_creat, _wcreat
_open, _wopen