_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 en 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_sdevuelve el valor 0 si el tamaño de archivo cambia correctamente.Devuelve un valor distinto de cero indica un error: el valor devuelto es EACCESsi el archivo especificado está bloqueado y el acceso, EBADFsi el archivo especificado es de solo lectura o descriptor es no válido, ENOSPCsi no se permite ningún espacio en el dispositivo, o EINVALsi es el tamaño menor que cero.errnoestá establecida en el mismo valor.
Para obtener más información sobre éstos y otros códigos de retorno, vea _doserrno, errno, _sys_errlist, y _sys_nerr.
Comentarios
La función de _chsize_sextiende 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_stoma 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._chsizese 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 es el tamaño 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.