4D Internet Commands v14

FTP_GetDirList

Página Inicial

 
4D Internet Commands v14
FTP_GetDirList

FTP_GetDirList 


 

FTP_GetDirList ( ftp_ID ; viaServidor ; nomes ; tams ; tipos ; datasMod ; horasMod ) -> Resultado 
Parâmetro Tipo   Descrição
ftp_ID  Inteiro longo in Referencia de uma conexão FTP
viaServidor  Texto in Via de acesso a um diretório Unix no servidor FTP
in Diretório de trabalho atual (CWD)
nomes  Array cadeia in Lista de nomes
tams  Array inteiro longo in Lista de tamanhos
tipos  Array inteiro in 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 in Lista das datas de modificação
horasMod  Array inteiro longo in Lista de horas de modificação
Resultado  Inteiro in Código de erro

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:

TipoArquivo
0arquivo ordinário
1diretório
2arquivo especial de tipo bloqueio
3arquivo especial de tipo caráter
4link simbólico (além dos arquivos ou pastas)
5arquivo especial FIFO
6porta 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.

 
PROPRIEDADES 

Produto: 4D Internet Commands
Tema: IC File Transfer
Número 88944

 
HISTÓRIA 

Modificado: 4D Internet Commands 2003

 
VER TAMBÉM 

FTP_ChangeDir
FTP_Login
FTP_PrintDir
FTP_VerifyID

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)