TsgcSTUNServerMetody › AddBinding

AddBinding Metoda

Dodaje dodatkowy punkt nasłuchiwania (IP/port) do serwera STUN bez ponownego uruchamiania aktualnie aktywnych powiązań.

Składnia

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

Parametry

NazwaTypOpis
aIPAddressconst stringLokalny adres IPv4/IPv6, do którego należy się powiązać. Aby nasłuchiwać na wszystkich interfejsach, należy użyć pustego ciągu, 0.0.0.0 lub ::.
aPortIntegerLokalny port UDP (od 1 do 65535), na którym serwer STUN akceptuje żądania Binding Request. Należy użyć wartości 3478, aby dopasować port STUN zarezerwowany przez IANA.

Wartość zwracana

Nowo utworzony obiekt TIdSocketHandle lub istniejący, gdy wpis dla tego samego adresu IP/portu jest już obecny. Uchwyt jest własnością wewnętrznej kolekcji Bindings i nie może być zwalniany przez wywołującego. (TIdSocketHandle)

Uwagi

Metoda AddBinding dodaje punkt nasłuchiwania do serwera, gdy właściwość Active ma wartość True, bez zatrzymywania już istniejących powiązań. Umożliwia udostępnianie usługi STUN na kilku interfejsach (na przykład IPv4 i IPv6 na tym samym hoście) lub włączenie atrybutu OTHER-ADDRESS, który wymaga dostępności serwera pod drugim adresem/portem. Gdy podany adres IP/port jest już powiązany, zwracany jest istniejący uchwyt i nie jest otwierane dodatkowe gniazdo. Atrybuty OTHER-ADDRESS / RESPONSE-ORIGIN generowane w pomyślnych odpowiedziach Binding są wyprowadzane ze zbioru aktywnych powiązań.

Przykład

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

Powrót do metod