_chsize_s

Artigo
02/25/2013

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.