CpyT2S

CpyT2S ( < cOrigem>, < cDestino>, [ lCompacta] ) --> lRet

(lógico)
• Retorna, verdadeiro (.T.), se o arquivo for copiado com sucesso
• Retorna falso (.F.), em caso de falha na cópia.

A função CpyT2S exige que o programa AdvPL que a execute seja um SmartClient, não permitindo, portanto, que seja chamada em JOB. A partir da build 7.00.120420A, caso a função seja chamada em JOB, o programa será finalizado com ocorrência de erro fatal (Function CpyT2S doesn't available in JOB.). Nas builds anteriores, se CpyT2S fosse chamada em JOB, ela não era executada e não gerava mensagem de advertência ou ocorrência de erro.

Caso a compactação esteja habilitada ( Default = .T. ) , no parâmetro <lCompacta>, o arquivo será compactado automaticamente no client antes do envio, e descompactado automaticamente no servidor. Para a grande parte dos tipos de arquivo, utilizar a compactação reduz o tempo de cópia, pois o conteúdo trafegado pela rede é menor. Para tráfego de arquivos que já possuem algum tipo de compressão de dados ( ZIP, TAR, RAR, JPG, MPG ), é mais eficiente especificar este parâmetro com .F., para que a compactação automática não seja utilizada, pois nestes casos a mesma não agregará nenhum ganho neste processo.

O diretório no destino (servidor) deve existir para que a cópia seja realizada com sucesso. Caso a cópia falhe, para identificação do motivo do erro, a função FError deve ser chamada.

// Copia arquivos do remote local para o servidor, compactando antes de transmitir
CpyT2S( "C:\TEMP\MANUAL.DOC", "\BKP" )

// Copia arquivos do remote local para o servidor, sem compactar antes de transmitir
CpyT2S( "C:\TEMP\MANUAL.DOC", "\BKP", .F. )