FRenameEx

FRenameEx ( < cArquivo>, < cNovoArq>, [ nWhere] ) --> nRet

(numerico)
• Retorna 0 (zero), se a operação for realizada com sucesso; caso contrário, retornará -1 se falhar. Em caso de falha, utilize a função FError() para obter mais detalhes.

• Para renomear o arquivo, este deve estar fechado. Isto é, não pode estar em uso por nenhum outro processo ou estação. Caso o arquivo esteja aberto, a operação de renomear não será realizada.
• É possível renomear o arquivo especificando nos parâmetros, simultaneamente, um diretório do servidor e da estação remota, bem como especificar dois arquivos remotos e executar a função através de um JOB.
• Essa função não aceita caracteres curingas (Wild cards), tais como: * e/ou ?.

Tabela de valores - Parâmetro <nWhere>

// Neste exemplo, a função é utilizada para 3 finalidades diferentes, observe:// Renomeando um arquivo na estação de origem.txt para destino.txt , na pasta c:\TempnStatus1 := frename('c:\Temp\Origem.txt' , 'c:\Temp\Destino.txt' )IF nStatus1 == -1      MsgStop('Falha na operação 1 : FError '+str(ferror(),4))Endif// Renomeando um arquivo no servidor, na pasta sigaadv, de error.log para error.oldnStatus2 := frename('\sigaadv\error.log' , '\sigaadv\error.old' )IF nStatus2 == -1      MsgStop('Falha na operação 2 : FError '+str(ferror(),4))Endif// Movendo um arquivo no Client, da pasta Raiz para a pasta c:\Temp , alterando também o nome do arquivo.nStatus3 := frename('c:\Lista.txt','c:\Temp\OldLista.txt')IF nStatus3 == -1      MsgStop('Falha na operação 3 : FError '+str(ferror(),4))Endif