TsgcSTUNServerMethoden › RemoveBinding

RemoveBinding Methode

Entfernt einen zuvor hinzugefügten Listening-Endpunkt und schließt dessen Socket, ohne den STUN-Server zu stoppen.

Syntax

function RemoveBinding(const aIPAddress: string; aPort: Integer): Boolean;

Parameter

NameTypBeschreibung
aIPAddressconst stringLokale IP-Adresse des zu entfernenden Bindings. Muss mit dem Wert übereinstimmen, der zuvor an AddBinding übergeben wurde (oder dem Host des Standard-Bindings).
aPortIntegerLokaler UDP-Port des zu entfernenden Bindings.

Rückgabewert

True, wenn ein passender Endpunkt gefunden und entfernt wurde; False, wenn kein Binding mit der angegebenen IP/Port existiert. (Boolean)

Hinweise

RemoveBinding ist das Laufzeit-Gegenstück zu AddBinding: Es stoppt den an den passenden Endpunkt angehängten Listener-Thread, schließt dessen UDP-Socket und entfernt den Eintrag aus der internen Bindings-Sammlung, während die verbleibenden Endpunkte STUN-Anfragen unverändert weiter bedienen. Es wird typischerweise verwendet, um eine redundante Schnittstelle zu entfernen, den Listening-Port ohne Aufruf von ReStart zu rotieren oder eine sekundäre Adresse abzubauen, sobald sie nicht mehr benötigt wird. Wenn kein Eintrag der angegebenen IP/dem Port entspricht, bleibt der Server unangetastet und die Methode gibt False zurück.

Beispiel

if not oSTUN.RemoveBinding('0.0.0.0', 3478) then
  ShowMessage('STUN binding not found');

Zurück zu Methoden