Acepta una conexión entrante, que pasa a estar disponible para la transferencia de datos. La dirección IP de origen y el puerto de origen de donde procede la conexión están disponibles como salidas.
El valor de retorno de BOOL es TRUE si la función se ha ejecutado correctamente. Evalúe la propiedad Result en caso de que el valor de retorno sea FALSE.
Fase |
Descripción |
---|---|
1 |
Estado inicial: |
2 |
Llamada funcional |
3 |
Estado: |
4 |
Estado final: Listening; de lo contrario, se detecta un error |
La pila TCP acepta inmediatamente las conexiones entrantes y se retienen como pendientes. Para el cliente se trata de una conexión normal y puede enviar datos al servidor. Por lo tanto, es posible que se acepte una conexión que el cliente ya haya cerrado. Los datos recibidos de este cliente siguen estando disponibles y mientras los datos no se lean utilizando uno de los métodos de recepción, la conexión sigue registrada dentro de la propiedad ConnectedClients. Cuando los datos de dicha conexión cliente se hayan leído utilizando un método Receive, esta conexión cliente desaparecerá de la lista proporcionada con la propiedad ConnectedClients.
El número de conexiones retenidas como pendientes se puede establecer en la GPL de esta biblioteca con el parámetro Gc_uiTCPServerMaxBacklog (consulte Variables globales).
Salida |
Tipo de datos |
Rango válido |
Descripción |
---|---|---|---|
q_sClientIP |
STRING(15) |
- |
IP del cliente aceptado codificada como un valor de cadena. |
q_dwClientIP |
DWORD |
- |
Dirección IP del cliente como DWORD; cada byte representa un dígito de la dirección IPv4. |
q_uiClientPort |
UINT |
1 ... 65535 |
Puerto de origen desde donde se conecta el cliente. |