Função: CpyT2S
Copia um arquivo (compactado ou não) do client (Remote) para o servidor.
CpyT2S ( < cOrigem>, < cDestino>, [ lCompacta] ) --> lRet
Nome | Tipo | Descrição | Obrigatório | Referência |
cOrigem | Caracter | Indica o nome do arquivo será copiado, além de aceitar caracteres curingas (* e ?). | X | |
cDestino | Caracter | Indica o diretório de destino dos arquivos no servidor. | X | |
lCompacta | Lógico | Indica se o arquivo deve ser internamente compactado antes de fazer a cópia. Default = .T. ( verdadeiro ) |
- (lógico)
- Retorna, verdadeiro (.T.), se o arquivo for copiado com sucesso
- Retorna falso (.F.), em caso de falha na cópia.
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. )
Quando o SmartClient utilizado for uma build nativa Linux ou Mac, sabe-se que sistema de arquivos destas plataformas não têm unidade de disco, a nomenclatura dos arquivos é case sensitive ( letras minúsculas diferente de maiúsculas ), e as barras separadoras de diretório / pasta são barras normais "/" ao invés de barras inversas "\". Mesmo nestes casos, deve-se especificar uma letra de unidade de disco no diretório de destino; pois quando o SmartClient em Linux e/ou Mac receber o diretório de destino, com a unidade de disco especificada, a unidade de disco será ignorada e as barras serão internamente invertidas.
Por exemplo, a cópia especificando o path de destino "C:\USER\LOCAL\TEMP\" será interpretado pelo smartclient Linux e/ou Max como "/user/local/temp/"