TsgcSTUNServerMethods › AddBinding

AddBinding Methode

Fügt dem STUN-Server einen zusätzlichen Listening-Endpunkt (IP/Port) hinzu, ohne die aktuell aktiven Bindings neu zu starten.

Syntax

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

Parameter

NameTypBeschreibung
aIPAddressconst stringLokale IPv4-/IPv6-Adresse, an die gebunden werden soll. Verwenden Sie eine leere Zeichenfolge, 0.0.0.0 oder ::, um auf jeder Schnittstelle zu lauschen.
aPortIntegerLokaler UDP-Port (1 bis 65535), auf dem der STUN-Server Binding Requests annimmt. Verwenden Sie 3478, um dem von der IANA reservierten STUN-Port zu entsprechen.

Rückgabewert

Der neu erstellte TIdSocketHandle oder der vorhandene, wenn bereits ein Eintrag für dieselbe IP/denselben Port vorhanden ist. Das Handle gehört der internen Bindings-Sammlung und darf nicht vom Aufrufer freigegeben werden. (TIdSocketHandle)

Hinweise

AddBinding fügt dem Server einen Listening-Endpunkt hinzu, während Active True ist, ohne eine bereits vorhandene Bindung zu stoppen. Verwenden Sie es, um den STUN-Dienst auf mehreren Schnittstellen bereitzustellen (zum Beispiel IPv4 und IPv6 auf demselben Host) oder um das OTHER-ADDRESS-Attribut zu aktivieren, das erfordert, dass der Server unter einer zweiten Adresse/einem zweiten Port erreichbar ist. Wenn die angegebene IP/der angegebene Port bereits gebunden ist, wird das vorhandene Handle zurückgegeben und kein zusätzlicher Socket geöffnet. Die in erfolgreichen Binding-Responses erzeugten OTHER-ADDRESS-/RESPONSE-ORIGIN-Attribute werden aus der Menge der aktiven Bindungen abgeleitet.

Beispiel

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

Zurück zu Methoden