FTP_GetDirList

4D Internet Commands v16

FTP_GetDirList


FTP_GetDirList ( ftp_ID ; rutaServidor ; nombres ; tams ; tipos ; fechasMod ; horasMod ) -> resultado

Parámetro	Tipo	Descripción
ftp_ID	Entero largo	Referencia de una conexión FTP
rutaServidor	Texto	Ruta de acceso a un directorio Unix en el servidor FTP
		Directorio de trabajo actual (CWD)
nombres	Array cadena	Lista de nombres
tams	Array entero largo	Lista de tamaños
tipos	Array entero	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	Lista de las fechas de modificación
horasMod	Array entero largo	Lista de horas de modificación
resultado	Entero	Código de error

Descripción

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:

Tipo	Archivo
0	archivo ordinario
1	directorio
2	archivo especial de tipo bloque
3	archivo especial de tipo carácter
4	enlace simbólico (alias de los archivos o carpetas)
5	archivo especial FIFO
6	puerto 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