4D Internet Commands v16

FTP_GetDirList

Inicio

 
4D Internet Commands v16
FTP_GetDirList

FTP_GetDirList 


 

FTP_GetDirList ( ftp_ID ; rutaServidor ; nombres ; tams ; tipos ; fechasMod ; horasMod ) -> resultado 
Parámetro Tipo   Descripción
ftp_ID  Entero largo in Referencia de una conexión FTP
rutaServidor  Texto in Ruta de acceso a un directorio Unix en el servidor FTP
in Directorio de trabajo actual (CWD)
nombres  Array cadena in Lista de nombres
tams  Array entero largo in Lista de tamaños
tipos  Array entero in Lista de tipos 0 = archivo normal, 1 = directorio, 2 = archivo especial de tipo bloque, 3 = archivo especial de tipo carácter, 4 = enlace simbólico, 5 = archivo especial FIFO, 6 = puerto de acceso de la familia de direcciones AF_UNIX
fechasMod  Array fecha in Lista de las fechas de modificación
horasMod  Array entero largo in Lista de horas de modificación
resultado  Entero in Código de error

El comando FTP_GetDirList devuelve la lista de los objetos en un directorio de la sesión FTP identificada por ftp_ID. La información sobre los nombres, tamaños, tipos, fechas y horas de modificación de los elementos del directorio se devuelve en arrays. Una conexión al sitio FTP debe haber sido abierta por FTP_Login y seguir siendo válida (FTP_VerifyID). El comando FTP_GetDirList reemplaza al directorio de trabajo actual (CWD) por el definido en el parámetro rutaServidor.

ftp_ID es la referencia entero largo de la sesión FTP establecida con FTP_Login.

directorio es un valor de texto en el formato de una rutaServidor que hace referencia a un directorio FTP. Una variable o campo 4D debe pasarse en este parámetro ya que el directorio de trabajo actual resultante será devuelto después de la ejecución del comando. Normalmente, el valor devuelto a este parámetro será el mismo que el valor que se pasa. Sin embargo, pueden haber casos (como las restricciones de acceso) donde el cambio de directorio no se  realiza correctamente. En este caso, el parámetro directorio tendrá la rutaServidor al directorio actual de la sesión.

Si pasa una cadena vacía en este parámetro, los arrays se llenan con las listas de los archivos del directorio actual y la ruta de acceso del directorio actual del servidor (CWD) se devuelve en el parámetro rutaservidor.

nombres es un array de tipo alfanumérico o texto que recibe el nombre de cada objeto en el directorio especificado.

tams es un array de tipo entero largo que recibe el tamaño de los objetos del directorio.

tipos es un array de tipo entero que recibe los valores de tipo de cada objeto del directorio. Estos son los valores posibles y los tipos correspondientes:

TipoArchivo
0archivo ordinario
1directorio
2archivo especial de tipo bloque
3archivo especial de tipo carácter
4enlace simbólico (alias de los archivos o carpetas)
5archivo especial FIFO
6puerto de acceso de la familia AF_UNIX

Nota: en el caso de un enlace simbólico (tipo = 4), el servidor FTP devuelve una ruta particular (Nombre de alias + símbolo + ruta de acceso al archivo o carpeta fuente). Si intenta utilizar esta ruta para acceder al archivo o carpeta fuente, se devuelve un error. Debe extraer la ruta de acceso del archivo o de la carpeta de origen de la cadena devuelta por FTP_GetDirList que comienza justo después del carácter simbólico. De lo contrario, los comandos tales como FTP_GetFileInfo devolverán el error -10085 ya que el archivo o  carpeta no se encuentra.

fechasMod es una array de tipo fecha que recibe la fecha de la última modificación de cada objeto del directorio.

horasMod es un array de tipo entero largo que recibe la hora de la última modificación de cada objeto en el directorio.

Recordatorio: en 4D, el tipo de array entero largo se utiliza para manipular los datos de tipo hora (cada elemento del array representa un número de segundos). Utilice el comando Time string para convertir estos valores al formato HH:MM:SS.



Ver también 

FTP_ChangeDir
FTP_Login
FTP_PrintDir
FTP_VerifyID

 
PROPIEDADES 

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

 
HISTORIA 

Modificado: 4D Internet Commands 2003

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v16)