Função: FClose
Fecha um arquivo binário aberto e escreve buffers de disco no DOS - Disk Operating System.
FClose ( [ nHandle] ) --> lRet
Nome | Tipo | Descrição | Obrigatório | Referência |
nHandle | Numérico | Indica handle do arquivo obtido, previamente, através da função FOpen() ou FCreate(). |
-
lRet(logico)
- Retorna falso (.F.), se ocorrer um erro enquanto os buffers estão sendo escritos; caso contrário, verdadeiro (.T.).
Essa função é de tratamento de arquivos de baixo nível utilizada para fechar arquivos binários e forçar que os respectivos buffers do DOS - Disk Operating System sejam escritos no disco. No entanto, caso a operação falhe, a função retornará falso (.F.).
Neste caso, pode-se utilizar a função FError() para determinar a razão exata da falha. Por exemplo, ao tentar usar FClose() com um handle (tratamento dado ao arquivo pelo sistema operacional) inválido retorna falso (.F.) e FError() retorna o erro 6 do DOS, invalid handle.
Importante |
---|
Esta função permite acesso de baixo nível a arquivos e dispositivos DOS - Disk Operating System (sistema operacional de disco). Desta forma, recomenda-se muita cautela na utilização e um conhecimento detalhado do sistema operacional. |
// Fecha um arquivo binário recém criado e exibe uma mensagem de erro caso o fechamento falhe#include "Fileio.ch"...nHandle := FCREATE("Testfile", FC_NORMAL)If !FCLOSE(nHandle) conout( "Erro ao fechar arquivo, erro numero: ", FERROR() )EndIf
Advanced Protheus 6.09
,
Advanced Protheus 7.10
,
Microsiga Protheus 8.11
,
Protheus 10
,
TOTVS Application Server 10
,
ByYou Application Server
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas