FERROR()
 Verifica se há erros após uma operaçao de arquivo binário
------------------------------------------------------------------------------

 Sintaxe

     FERROR() --> nCodErro

 Retorno

     FERROR() retorna o erro DOS da última operaçao de arquivo na forma de
     um valor numérico inteiro.  Caso nao haja erro algum, FERROR() retorna
     zero.

     Tabela 5-16: Valores de Retorno de FERROR()
     ------------------------------------------------------------------------
     Erro              Significado
     ------------------------------------------------------------------------
     0                 Sucesso
     2                 Arquivo nao encontrado
     3                 Path nao encontrado
     4                 Muitos arquivos abertos
     5                 Acesso negado
     6                 Handle inválido
     8                 Memória insuficiente
     15                Especificado um drive inválido
     19                Tentativa de gravar em disco protegido
     21                Disco nao pronto
     23                Erro de CRC
     29                Erro de gravaçao
     30                Erro de leitura
     32                Violaçao de compartilhamento
     33                Violaçao de travamento
     ------------------------------------------------------------------------

 Descriçao

     FERROR() é uma funçao de tratamento de arquivo de baixo nível utilizada
     para indicar erros DOS após uma funçao de tratamento de arquivo ter
     sido usada.  Tais funçoes incluem FCLOSE(), FCREATE(), FERASE(),
     FOPEN(), FREAD(), FREADSTR(), e FRENAME().  FERROR() retém seu valor
     até a próxima execuçao de uma funçao de tratamento de arquivo.

     -----------------------------------------------------------------------
     . Aviso

     Esta funçao permite acesso de baixo nível a arquivos e dispositivos do
     DOS.  Ela deve ser utilizada com extremo cuidado e exige que se conheça
     a fundo o sistema operacional.
     -----------------------------------------------------------------------

 Exemplos

     O exemplo a seguir testa FERROR() após a criaçao de um arquivo binário
     e exibe uma mensagem de erro caso haja falha na operaçao:

     #include "Fileio.ch"
     //
     nHandle := FCREATE("Temp.txt", FC_NORMAL)
     IF FERROR() != 0
        ? "Arquivo nao foi criado, erro DOS ", FERROR()
     ENDIF

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: DOSERROR() FCLOSE() FCREATE() FOPEN() FWRITE()