Metodo ReceiveFromFirstAvailableClient
Task
Lettura di dati memorizzati nel buffer di ricezione del primo client che dispone di dati pronti alla lettura e rimozione dei dati dal buffer se i dati sono stati letti senza errori.
Descrizione funzionale
Legge i dati memorizzati nel buffer di ricezione del primo client che dispone di dati pronti alla lettura e rimuove i dati dal buffer se i dati sono stati letti senza errori.
Il valore UDINT restituito indica il numero di byte scritti nel buffer fornito dall'applicazione.
Per ulteriori informazioni sui metodi di ricezione, consultare la sezione Metodo di ricezione.
Considerazioni per connessioni che utilizzano TLS
Il comportamento dei metodi Peek e Receive potrebbe essere diverso per le connessioni con TLS e senza TLS. in particolare quando si scambiano grandi pacchetti di dati. Quando si eseguono i metodi su una connessione che utilizza TLS, può essere richiesta l'esecuzione di più chiamate di metodo finché i dati non vengono copiati o spostati nel buffer applicazione. In ogni caso, prima di elaborare i dati, verificare la quantità di dati copiati o spostati e se i dati sono completi.
Interfaccia
|
Ingresso |
Tipo di dati |
Intervallo di valori valido |
Descrizione |
|---|---|---|---|
|
i_pbyReceiveBuffer |
POINTER TO BYTE |
- |
Indirizzo iniziale del buffer per la scrittura dei dati ricevuti. |
|
i_udiReceiveBufferSize |
UDINT |
1 ... 2147483647 |
Numero di byte da leggere.
NOTA: Il valore non deve essere superiore alle dimensioni del buffer.
|
|
In_Out |
Tipo di dati |
Intervallo di valori valido |
Descrizione |
|---|---|---|---|
|
iq_udiFillLevel |
UDINT |
1 ... 2147483647 |
Indica il livello di riempimento del buffer. Prima del richiamo della funzione: i dati verranno scritti a partire da questo offset. Dopo il richiamo della funzione: i dati vengono aggiornati aggiungendo il numero di byte scritti al valore originale. |
|
Uscita |
Tipo di dati |
Intervallo di valori valido |
Descrizione |
|---|---|---|---|
|
q_sClientIP |
STRING(15) |
- |
Indirizzo IP del client. |
|
q_dwClientIP |
DWORD |
- |
Indirizzo IP del client come DWORD; ogni byte rappresenta una cifra dell'indirizzo IPv4. |
|
q_uiClientPort |
UINT |
- |
Porta sorgente del client. |