TsgcSTUNServerMetodi › AddBinding

AddBinding Method

Aggiunge un endpoint di ascolto aggiuntivo (IP/porta) al server STUN senza riavviare i binding attualmente attivi.

Sintassi

function AddBinding(const aIPAddress: string; aPort: Integer) : TIdSocketHandle;

Parametri

NomeTipoDescrizione
aIPAddressconst stringIndirizzo IPv4/IPv6 locale a cui fare il bind. Utilizzare una stringa vuota, 0.0.0.0 o :: per ascoltare su ogni interfaccia.
aPortIntegerPorta UDP locale (da 1 a 65535) sulla quale il server STUN accetta le Binding Request. Utilizzare 3478 per corrispondere alla porta STUN riservata da IANA.

Valore restituito

Il TIdSocketHandle appena creato, oppure quello esistente quando è già presente una voce per lo stesso IP/porta. L'handle è di proprietà della collezione Bindings interna e non deve essere liberato dal chiamante. (TIdSocketHandle)

Note

AddBinding aggiunge un endpoint di ascolto al server mentre Active è True, senza interrompere eventuali binding già attivi. Utilizzarlo per esporre il servizio STUN su più interfacce (ad esempio IPv4 e IPv6 sullo stesso host), o per abilitare l'attributo OTHER-ADDRESS che richiede che il server sia raggiungibile su un secondo indirizzo/porta. Quando l'IP/porta specificati sono già in ascolto, viene restituito l'handle esistente e non viene aperto alcun socket aggiuntivo. Gli attributi OTHER-ADDRESS / RESPONSE-ORIGIN prodotti nelle Binding Response corrette sono derivati dall'insieme dei binding attivi.

Esempio

oSTUN.AddBinding('0.0.0.0', 3478);
oSTUN.AddBinding('::', 3478);
oSTUN.Active := True;

Torna ai Metodi