_chsize_s

Artigo
08/25/2010

Altera o dimensionar de um arquivo.Esta é uma versão de _chsize com aprimoramentos de segurança sistema autônomo descrito em Aprimoramentos de segurança no CRT.

errno_t _chsize_s( 
   int fd,
   __int64 size 
);

Parâmetros

fd
Descritor de arquivo se referindo a um arquivo em aberto.
size
Novo tamanho do arquivo em bytes.

Valor de retorno

_chsize_s Retorna o valor 0 se o dimensionar do arquivo for alterado com êxito. Um valor retornado diferente de zero indica um erro: o valor retornado é EACCES Se o arquivo especificado estiver protegido contra acesso, EBADF Se o arquivo especificado é somente leitura ou o descritor for inválido, ENOSPC Se ficar sem espaço no dispositivo, ou EINVAL Se dimensionar for menor que zero. errno é definido como 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

The _chsize_s função estende ou trunca o arquivo associado fd o comprimento especificado pela size. O arquivo deve estar em aberto em um modo que permite gravação.Caracteres nulo ('\0') são acrescentados se o arquivo será estendido.Se o arquivo é truncado, todos os dados do participante de arquivo reduzido para o comprimento original do arquivo serão perdidos.

_chsize_s leva um inteiro de 64 bit sistema autônomo o dimensionar do arquivo e, portanto, pode manipular o dimensionar do arquivo ultrapassa 4 GB. _chsize é limitada a tamanhos de arquivos de 32 bit.

Esta função valida os parâmetros.If fd não é um descritor de arquivo válido ou o dimensionar for menor que zero, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro.