4D Doc Center : FTP

4D Internet Commands v14

FTP_GetDirList


FTP_GetDirList ( ftp_ID ; viaServidor ; nomes ; tams ; tipos ; datasMod ; horasMod ) -> 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
		Diretório de trabalho atual (CWD)
nomes	Array cadeia	Lista de nomes
tams	Array inteiro longo	Lista de tamanhos
tipos	Array inteiro	Lista de tipos 0 = arquivo normal, 1 = diretório, 2 = arquivo especial de tipo bloqueio, 3 = arquivo especial de tipo caráter, 4 = link simbólico, 5 = arquivo especial FIFO, 6 = porta de acesso da familia de direções AF_UNIX
datasMod	Array data	Lista das datas de modificação
horasMod	Array inteiro longo	Lista de horas de modificação
Resultado	Inteiro	Código de erro

Descrição

O comando FTP_GetDirList devolve a lista dos objetos em um diretório da sessão FTP identificada por ftp_ID. A informação sobre os nomes, tamanhos, tipos, datas e horas de modificação dos elementos do diretório se devolve em arrays. Uma conexão ao site FTP deve ter sido aberta por FTP_Login e seguir sendo válida (FTP_VerifyID). O comando FTP_GetDirList substitui ao diretório de trabalho atual (CWD) definido no parâmetro viaServidor.

ftp_ID é a referencia inteiro longo da sessão FTP estabelecida com FTP_Login.

diretorio é um valor de texto no formato de uma viaServidor que faz referência a um diretório FTP. Uma variável ou campo 4D deve ser passado neste parâmetro como o diretório de trabalho atual resultante será devolvido depois da execução do comando. Normalmente, o valor devolvido a este parâmetro será o mesmo que o valor que é passado. No entanto, podem ter casos (como as restrições de acesso) aonde a mudança de diretório não se realiza corretamente. Neste caso, o parâmetro diretório terá a viaServidor ao diretório atual da sessão.

Se passada uma cadeia vazia neste parâmetro, os arrays são levados com as listas dos arquivos do diretório atual e a via de acesso do diretório atual do servidor (CWD) é devolvido no parâmetro viaServidor.

nomes é um array de tipo alfanumérico ou texto que recebe o nome de cada objeto no diretorio especificado.

tams é um array de tipo inteiro longo que recebe o tamanho dos objetos do diretorio.

tipos é um array de tipo inteiro que recebe os valores de tipo de cada objeto do diretório. Estes são os valores possíveis e os tipos correspondentes:

Tipo	Arquivo
0	arquivo ordinário
1	diretório
2	arquivo especial de tipo bloqueio
3	arquivo especial de tipo caráter
4	link simbólico (além dos arquivos ou pastas)
5	arquivo especial FIFO
6	porta de acesso da família AF_UNIX

Nota: No caso de um link simbólico (tipo = 4), o servidor FTP devolve uma via particular (Nome de alias + símbolo + via de acesso ao arquivo ou pasta fonte). Se tenta utilizar esta via para acessar ao arquivo ou pasta fonte, é devolvido um erro. Deve extrair a rota de acesso do arquivo ou da pasta de origem da cadeia devolvida por FTP_GetDirList que começa justo depois do caráter simbólico. Caso contrário, os comandos tais como FTP_GetFileInfo devolverão o erro -10085 como o arquivo ou pasta não é encontrado.

datasMod é um array de tipo data que recebe a data da última modificação de cada objeto do diretorio.

horasMod é um array de tipo inteiro longo que recebe a hora da última modificação de cada objeto no diretorio.

Lembrete: em 4D, o tipo de array inteiro longo se utiliza para manipular os dados de tipo hora (cada elemento do array representa um número de segundos). Utilize o comando Time string para converter estes valores ao formato HH:MM:SS.