_chsize_s
Altera o tamanho de um arquivo.Esta é uma versão do _chsize com aprimoramentos de segurança, conforme descrito em Recursos de segurança no CRT.
errno_t _chsize_s(
int fd,
__int64 size
);
Parâmetros
fd
Descritor de arquivo se referindo a um arquivo aberto.size
Novo tamanho do arquivo em bytes.
Valor de retorno
_chsize_s Retorna o valor 0 se o tamanho do arquivo for alterado com êxito.Um valor de retorno diferente de zero indica um erro: o valor de retorno é EACCES se o arquivo especificado está bloqueado contra acesso, EBADF se o arquivo especificado é somente leitura ou o descritor é inválido, ENOSPC se ficar sem espaço no dispositivo, ou EINVAL se o tamanho é menor que zero.errno é definido para o mesmo valor.
Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist e _sys_nerr.
Comentários
O _chsize_s função amplia ou trunca o arquivo associado fd para o comprimento especificado pela size.O arquivo deve estar aberto em um modo que permita a gravação.Caracteres nulos ('\0') são acrescentados se o arquivo é estendido.Se o arquivo é truncado, todos os dados do final do arquivo abreviado para o tamanho original do arquivo serão perdidos.
_chsize_s leva um inteiro de 64 bits, como o tamanho do arquivo e, portanto, pode lidar com arquivos maiores que 4 GB._chsize é limitado ao tamanho dos arquivos de 32 bits.
Esta função valida seus parâmetros.Se fd não é um descritor de arquivo válido ou o tamanho é menor que zero, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.
Requisitos
Rotina |
Cabeçalho necessário |
Cabeçalho opcional |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.