_chsize_s

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Cambia el tamaño de un archivo. Se trata de una versión de _chsize con mejoras de seguridad, como se describe en características de seguridad de CRT.

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.

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

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

El _chsize_s función amplía o trunca el archivo asociado a fd a la longitud especificada por size. El archivo debe estar abierto en un modo que permite escritura. Si el archivo se amplía, se anexan caracteres nulos ('\0'). Si el archivo se trunca, todos los datos desde el final del archivo abreviado para la longitud del archivo original se pierde.

_chsize_stoma un entero de 64 bits como el tamaño del archivo y, por tanto, puede controlar los tamaños de archivo mayores que 4 GB. _chsizese limita al tamaño de los archivos de 32 bits.

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

RutinaEncabezado necesarioEncabezado opcional
_chsize_s<io.h><errno.h>

Para obtener más información sobre compatibilidad, vea Compatibility en la introducción.

Control de archivos
_chsize
_Close
_creat, _wcreat
_open, _wopen

Mostrar: