_chsize_s
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.
Requisitos
Rotina |
Cabeçalho necessário |
Cabeçalho opcional |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.