4D Doc Center : FTP

4D Internet Commands v14

FTP_ChangeDir


FTP_ChangeDir ( ftp_ID ; viaServidor ) -> Resultado

Parâmetro	Tipo	Descrição
ftp_ID	Inteiro longo	Referencia de uma conexão FTP
viaServidor	Texto	Via de acesso a um diretório Unix no servidor FTP
Resultado	Inteiro	Código de erro

Descrição

O comando FTP_ChangeDir permite designar o diretório de trabalho atual (Current Working Directory ou CWD) no servidor FTP.

Nota: Também é possível modificar o diretório de trabalho atual com ajuda dos comandos FTP_GetDirList e FTP_GetFileInfo. No entanto, o comando FTP_ChangeDir é mais rápido e necessita menos parâmetros.

ftp_ID é o identificador da sessão FTP estabelecida com FTP_Login.

O parâmetro viaServidor contém uma via de acesso ao formato Unix referenciando um diretório FTP existente e acessível. Se o diretório FTP especificado é inválido (inexistente ou com direitos de acesso insuficientes), FTP_ChangeDir devolve um erro e não modifica o repertório de trabalho atual.

Exemplo

O seguinte exemplo designa a raiz do servidor FTP como diretório de trabalho atual:

$err:=FTP_ChangeDir(ftp_ID;"/")