AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Comunicación / Funciones FTP
  • Navegador de Internet
  • Error de seguridad en una conexión FTPS segura
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Conecta el ordenador actual a un servidor FTP (File Transfer Protocol).
WINDEVWindows Los modos de conexión segura disponibles son los siguientes:
  • FTPS: FTP asegurado según el protocolo SSL con encriptación implícita.
  • FTPES: FTP asegurado según el protocolo SSL con encriptación explícita.
  • SFTP: FTP asegurado por un canal SSH.
Ejemplo
// Connect the current computer to the FTP server
ResConnect = FTPConnect("192.54.12.8")
Sintaxis
<Result> = FTPConnect(<Server> [, <User name> [, <Password> [, <Port number> [, <Type of connection> [, <Connection timeout> [, <Private key> [, <Key password>]]]]]]])
<Result>: Integro
  • Identificador de la conexión,
  • 0 durante la primera conexión.
  • -1 si se produce un error. Los detalles del error son devueltos por ErrorInfo con la constante errCode o errMessage.
    Si se produce un error de identificación, ErrorInfo con la constante errCode devuelve la constante ftpErrorAuthentification.
<Server>: Cadena de caracteres (con comillas)
Nombre del servidor FTP ("ftp.cdrom.com" por ejemplo) o dirección IP del servidor FTP ("192.54.12.8" por ejemplo).
WINDEVWindows Este parámetro se utiliza para definir el protocolo utilizado:
  • si el nombre del servidor empieza por "ftp://", la conexión se establece en modo no seguro.
  • si el nombre del servidor comienza por "ftps://", la conexión se establece en modo seguro según el protocolo FTPS (FTP protegido por SSL con encriptación implícita).
  • si el nombre del servidor comienza por "ftpes://", la conexión se establece en modo seguro según el protocolo FTPES (FTP protegido por SSL con cifrado explícito).
  • si el nombre del servidor empieza por "sftp://", la conexión se establece en modo seguro a través de un canal SSH según el protocolo SFTP.
<User name>: Cadena de caracteres opcional (con comillas)
  • Nombre del usuario que intenta realizar una conexión con nombre (autenticación de usuario en el servidor FTP). Este parámetro es dado por el administrador del servidor FTP.
  • Cadena vacía (""") para realizar una conexión anónima.
<Password>: Cadena de caracteres opcional (con comillas)
Contraseña del usuario: usado para identificar al usuario en el servidor FTP. Este parámetro es dado por el administrador del servidor FTP.
Esta contraseña corresponde a:
  • la <Contraseña> especificada si este parámetro no es una cadena vacía ("""),
  • la dirección de correo electrónico del usuario si <Nombre de usuario> no se especifica o es igual a una cadena vacía ("""),
  • una cadena vacía (""") si no se especifica este parámetro y si <Nombre de usuario> no corresponde a una cadena vacía (""").
<Port number>: Entero opcional
Número del puerto en el que se ejecutará el servidor. Este parámetro es dado por el administrador del servidor FTP.
Por defecto:
  • para una conexión no segura, este puerto es el puerto 21.
  • WINDEVWindows para una conexión segura en modo FTPS, este puerto es el puerto 990.
  • WINDEVWindows para una conexión segura en modo FTPES, este puerto es el puerto 21.
  • WINDEVWindows para una conexión segura en modo SFTP, este puerto es el puerto 22.
<Type of connection>: Constante opcional de tipo Integer
Tipo de conexión a establecer:
ftpActiveMode (o False para compatibilidad)Conexión activa al servidor FTP.
Durante la transferencia de un archivo, el cliente toma la iniciativa de la transferencia. Este tipo de conexión puede ser rechazada por algunos servidores FTP protegidos.
ftpPassiveMode (o True para compatibilidad)
(Valor predeterminado)
Conexión pasiva al servidor FTP (modo PASV).
Al transferir archivos, el servidor toma la iniciativa para la transferencia. Este tipo de conexión se utiliza para pasar por encima de algunos "firewalls".
Observación: Si la conexión al servidor es en IPV6, la conexión se realizará en modo pasivo extendido (porque el modo pasivo no soporta IPV6)..
ftpExtendedPassiveModeConexión pasiva extendida al servidor FTP (modo EPSV).
Al transferir archivos, el servidor toma la iniciativa para la transferencia. Este tipo de conexión se utiliza para pasar por encima de algunos "firewalls"..
Si el servidor no soporta el modo pasivo extendido (el comando FEAT se envía al servidor para averiguar la capacidad), la conexión se interrumpe en modo pasivo simple..
Limitaciones:
  • Este modo no se soporta cuando se utiliza el módulo "wininet" de Windows (ver Parámetros FTP): la conexión se realiza en ftpPassiveMode.
  • Java Constante no disponible.
<Connection timeout>: Entero o duración opcional
Número de segundos después de los cuales se cancela la solicitud de conexión al servidor FTP (20 por defecto). Este tiempo de espera se aplica a todas las operaciones FTP realizadas en esta conexión.. Si no se recibe ninguna respuesta del servidor durante el tiempo de espera de conexión especificado, FTPConnect devuelve -1.
Observación: Este parámetro puede corresponder a:
  • un número entero correspondiente al número de segundos,
  • una variable de tipo Duration,
  • la indicación directa de la duración (por ejemplo, "1s").
<Private key>: Cadena de caracteres opcional (con comillas)
WINDEVWindows Nombre y ruta del archivo correspondiente a la clave privada utilizada durante una conexión en modo SFTP. Este fichero debe haber sido generado en formato OpenSSH.
Si no se especifica este parámetro, la conexión segura utiliza una autenticación mediante <Nombre de usuario>/<Contraseña>..
<Key password>: Cadena de caracteres ANSI opcional (con comillas)
WINDEVWindows Contraseña del archivo que contiene la clave privada utilizada durante una conexión en modo SFTP. Si no se especifica este parámetro, la conexión segura utiliza una autenticación mediante <Nombre de usuario>/<Contraseña>..
Observaciones
WINDEVWindowsCódigo de Usuario (UMC)

Navegador de Internet

La función FTPConnect requiere Internet Explorer en versión 3 o posterior.
Las modificaciones realizadas en <Timeout> no tienen efecto con algunas versiones de Internet Explorer. Es un problema conocido de los componentes de Microsoft que se corrige en las versiones más recientes de Internet Explorer (versión 5.1 y posteriores).
WINDEVWindowsLinux

Error de seguridad en una conexión FTPS segura

Durante una transacción segura, la función puede fallar debido a errores de seguridad:
  • certificado no válido o certificado procedente de una empresa desconocida.
  • nombre del sitio que se encuentra en el certificado que no corresponde a un servidor.
  • fecha del certificado inválido o caducado.
Usted tiene la capacidad de conectarse mientras ignora estos errores. Para ello, utilice la función FTP.IgnorarError variable:
Valor de FTP.IgnoreError
(estos valores se pueden combinar)
Descripción
ftpIgnoreInvalidCertificateEl certificado se ignora.
ftpIgnorarCertificadoVencidoSe ignora la fecha del certificado.
ftpIgnoreInvalidCertificateNameSe ignora el nombre del sitio especificado en el certificado.
ftpIgnorarRevocaciónSe ignora la revocación del certificado.
// Example for error management

xnum is int
FTP.IgnoreError = ftpIgnoreExpiredCertificate + ftpIgnoreInvalidCertificate + ...
ftpIgnoreInvalidCertificateName + ftpIgnoreRévocation
xnum = FTPConnect("ftpes://My_Server_IP", "My_User", "My_Password", 21, True)
IF xnum =-1  THEN
      Info(ErrorInfo(errMessage))
ELSE
      Info("OK")
END
Componente: wd290com.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Video FtpConnect
https://youtu.be/P3cQ9XJDGYk
amarildo
26 10 2018

Última modificación: 27/05/2022

Señalar un error o enviar una sugerencia | Ayuda local