_chsize_s

Artigo
06/09/2015

Altera o tamanho de um arquivo. Essa é uma versão de _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
O descritor de Arquivo que faz referência a um arquivo aberto.
size
Novo comprimento do arquivo em bytes.

Valor de retorno

_chsize_s retorna o valor 0 se o tamanho do arquivo é modificado com êxito. Um valor de retorno diferente de zero indica um erro: o valor de retorno é EACCES se o arquivo especificado está bloqueado de acesso, EBADF se o arquivo especificado é somente leitura ou o descritor for inválido, ENOSPC se nenhum espaço é deixado no dispositivo, ou EINVAL se o tamanho é menor que zero. errno é definido com o mesmo valor.

Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.

Comentários

A função de _chsize_s estende ou trunca o arquivo associado com fd ao comprimento especificado por size. O arquivo deve estar aberto em um modo que permite gravar. Os caracteres nulos (\ “0 ") são acrescentados se o arquivo é estendido. Se o arquivo é truncado, todos os dados do final do arquivo reduzido ao tamanho original do arquivo serão perdidos.

_chsize_s usa um inteiro de 64 bits do tamanho de arquivo e, consequentemente pode tratar tamanhos de arquivo maior que 4 GB. _chsize é limitado aos tamanhos de arquivo de 32 bits.

Essa função valida seus parâmetros. Se fd não é um descritor de arquivo válido ou o tamanho é menor que zero, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro.