_chsize_s
Cambia el tamaño de un archivo. Ésta es 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 en bytes de un archivo.
Valor devuelto
_chsize_s devuelve el valor 0 si el tamaño de archivo cambia correctamente. Devuelve un valor distinto de cero indica un error: el valor devuelto es EACCES si el archivo especificado está bloqueado y el acceso, EBADF si el archivo especificado es de solo lectura o descriptor es no válido, ENOSPC si no se permite ningún espacio en el dispositivo, o EINVAL si el tamaño es menor que cero. errno está establecida 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.
Comentarios
La función de _chsize_s extiende o trunca el archivo asociado a fd con la longitud especificada por size. El archivo debe estar abierto en un modo que permite escribir. Se agregan caracteres null (“\0”) si se mejora el archivo. Si se trunca el archivo, todos los datos del final del archivo abreviado a la longitud original del archivo se pierde.
_chsize_s toma un entero de 64 bits como el tamaño de archivo, por lo que puede controlar los tamaños de archivo mayor 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 descriptor de archivo válido o el tamaño es menor que cero, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.
Requisitos
Rutina |
Encabezado necesario |
Encabezado opcional |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.