_chsize_s

Altera o tamanho de um arquivo. Essa função é uma versão do com aprimoramentos de segurança, conforme descrito em Recursos de _chsize segurança na 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.

Retornar valor

_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 se o tamanho for menor que zero, o manipulador de parâmetros inválido será chamado, 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, consulte Estado global na CRT.

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_chsize_s	<io.h>	<errno.h>

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

Confira também

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