Metodo Accept
Descrizione funzionale
Accetta una connessione in entrata rendendola disponibile per il trasferimento di dati. L'indirizzo IP sorgente e la porta sorgente da cui proviene la connessione sono disponibili come uscite.
Il valore restituito BOOL è TRUE se la funzione è stata eseguita correttamente. Valutare la proprietà Result, nel caso il valore restituito sia FALSE.
Transizione di stato del server
|
Fase |
Descrizione |
|---|---|
|
1 |
Stato iniziale: |
|
2 |
Chiamata funzionale |
|
3 |
Stato: |
|
4 |
Stato finale: Listening, altrimenti viene rilevato un errore |
Gestione backlog
Le connessioni in entrata vengono accettate immediatamente dallo stack TCP e sono mantenute nel backlog. Per il client si tratta di una connessione normale ed è possibile inviare i dati al server. Perciò, è possibile che venga accettata una connessione già chiusa di nuovo dal client. I dati ricevuti da tale client sono ancora disponibili finché non vengono letti mediante uno dei metodi di ricezione, la connessione resta registrata nella proprietà ConnectedClients. Quando i dati di tale connessione del client sono stati letti tramite un metodo Receive, tale connessione scompare dall'elenco fornito con la proprietà ConnectedClients.
Il numero di connessioni conservate dal backlog può essere impostato nel GPL di questa libreria con il parametro Gc_uiTCPServerMaxBacklog (consultare Variabili globali).
Interfaccia
|
Uscita |
Tipo di dati |
Intervallo di valori valido |
Descrizione |
|---|---|---|---|
|
q_sClientIP |
STRING(15) |
- |
L'IP del client accettato contiene il valore di una stringa codificato. |
|
q_dwClientIP |
DWORD |
- |
Indirizzo IP del client come DWORD; ogni byte rappresenta una cifra dell'indirizzo IPv4. |
|
q_uiClientPort |
UINT |
1 ... 65535 |
La porta sorgente da cui proviene la connessione client. |