Este es el sitio web histórico de la documentación de 4D. La documentación se está trasladando progresivamente a developer.4d.com |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v19
TCP_Open
|
TCP_Open ( nomServidor ; puertoRemoto ; tcp_ID ; paramSesion ) -> resultado | ||||||||
Parámetro | Tipo | Descripción | ||||||
nomServidor | Cadena |
![]() |
Nombre o dirección IP del servidor | |||||
puertoRemoto | Entero |
![]() |
Puerto remoto al cual conectarse (0=indiferente) | |||||
tcp_ID | Entero largo |
![]() |
Referencia de la sesión TCP abierta | |||||
paramSesion | Entero |
![]() |
Parámetros de la sesión TCP 0 = Síncrono (Valor por defecto) 1 = Asíncrono 2 = Modo SSL síncrono, 3 = Modo SSL Asíncrono | |||||
resultado | Entero |
![]() |
Código de error | |||||
El comando TCP_Open abre una conexión TCP de salida a un dominio.
TCP_Open establece una conexión con nomServidor, en el puerto referenciado por puertoRemoto (si este parámetro es diferente de 0). Un valor entero largo se devuelve en tcp_ID, el cual será utilizado por todas las llamadas TCP posteriores que hagan referencia a la sesión. Por defecto, una sesión abierta por TCP_Open tiene un timeout de 30 segundos si no se reciben datos por la sesión identificada por el parámetro tcp_ID. El valor del timeout por defecto puede cambiarse utilizando el comando IT_SetTimeOut.
nomServidor es el nombre del servidor o la dirección IP de la máquina con la cual usted abre una conexión.
puertoRemoto indica que el puerto TCP de la máquina indicada por nomServidor, con la cual desea establecer una conexión.
Nota: después de una llamada a TCP_Open (o TCP_Listen), puertoRemoto puede devolver un valor negativo si el valor pasado en este parámetro es superior a 32767. Esto no va a perturbar la conexión. Para solucionar este problema, puede utilizar una variable intermedia:
$v_ RemotePort:=v_ RemotePort
$err:=TCP_Open(v_ RemoteHostIPAdr;0;v_ SessionID)
tcp_ID devuelve la referencia de la sesión abierta. Esta referencia será utilizada por todos los comandos TCP posteriores ejecutados en la sesión.
El parámetro opcional paramSesion da al usuario la posibilidad de elegir la configuración de la sesión TCP. Tenga en cuenta que estos valores se aplican a cada comando TCP llamado durante la sesión. El valor por defecto es 0 (Síncrono, no SSL).
SSL (Secured Socket Layer) es un protocolo que permite establecer comunicaciones TCP seguras (consulte la documentación de 4D para obtener más información y requisitos de instalación).
Cualquier conexión TCP abierto utilizando el comando TCP_Open debe estar cerrada más adelante mediante el comando TCP_Close.
En modo asíncrono, los comandos Internet de 4D devuelven el control al motor 4D inmediatamente después de su ejecución, sin esperar el final del proceso de conexión (sin esperar a que la conexión con el servidor remoto se establezca). El modo asíncrono es útil para las personas que no quieren que todos los comandos TCP utilicen tiempo de 4D.
En modo síncrono, los comandos Internet de 4D van al motor 4D (a otros procesos 4D) sólo cuando el proceso de conexión termina (con éxito o no).
Nota: el error 10089 puede ser devuelto al pasar 2 o 3, si no se puede abrir una conexión SSL (librería SLI no encontrada en la carpeta 4D Extensions).
Producto: 4D
Tema: IC TCP/IP
Número
88933
Modificado: 4D Internet Commands 6.8.1
4D Internet Commands ( 4D v19)