_chsize_s

Altera o tamanho de um arquivo. Essa função é uma versão do com aprimoramentos de _chsize segurança, conforme descrito em Recursos de segurança no CRT.

Sintaxe

errno_t _chsize_s(
   int fd,
   __int64 size
);

Parâmetros

fd
Descritor de arquivo que faz referência a um arquivo aberto.

size
Novo tamanho do arquivo em bytes.

Valor retornado

_chsize_s retornará o valor 0 se o tamanho do arquivo for alterado com sucesso. Um valor retornado diferente de zero indica um erro: o valor retornado será EACCES se o arquivo especificado estiver protegido contra acesso, EBADF se o arquivo especificado for somente leitura ou o descritor for inválido, ENOSPC se não restar espaço no dispositivo ou EINVAL se o tamanho for menor que zero. errno é definido como o mesmo valor.

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

Comentários

A função _chsize_s estende ou trunca o arquivo associado a fd para o comprimento especificado por size. O arquivo deve ser aberto em um modo que permita gravação. Caracteres nulos ('\0') que serão acrescentados se o arquivo for estendido. Se o arquivo for truncado, todos os dados do final do arquivo reduzido para o tamanho original do arquivo serão perdidos.

_chsize_s assume um inteiro de 64 bits como o tamanho do arquivo e, portanto, pode lidar com arquivos maiores que 4 GB. _chsize está limitado a tamanhos de arquivos de 32 bits.

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

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Manipulação de arquivos
_chsize
_close
_creat, _wcreat
_open, _wopen