TsgcSTUNServerMethods › AddBinding

AddBinding Method

Ajoute un point de terminaison d'écoute supplémentaire (IP/port) au serveur STUN sans redémarrer les liaisons actuellement actives.

Syntaxe

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

Paramètres

NomTypeDescription
aIPAddressconst stringAdresse IPv4/IPv6 locale à lier. Utilisez une chaîne vide, 0.0.0.0 ou :: pour écouter sur toutes les interfaces.
aPortIntegerPort UDP local (1 à 65535) sur lequel le serveur STUN accepte les requêtes Binding. Utilisez 3478 pour correspondre au port STUN réservé par l'IANA.

Valeur de retour

Le TIdSocketHandle nouvellement créé, ou celui existant lorsqu'une entrée pour le même IP/port est déjà présente. Le handle appartient à la collection Bindings interne et ne doit pas être libéré par l'appelant. (TIdSocketHandle)

Remarques

AddBinding ajoute un point de terminaison d'écoute au serveur pendant que Active est True, sans arrêter aucune liaison déjà en place. Utilisez-le pour exposer le service STUN sur plusieurs interfaces (par exemple IPv4 et IPv6 sur le même hôte), ou pour activer l'attribut OTHER-ADDRESS qui nécessite que le serveur soit joignable sur une seconde adresse/port. Lorsque l'IP/port fourni est déjà lié, le handle existant est retourné et aucun socket supplémentaire n'est ouvert. Les attributs OTHER-ADDRESS / RESPONSE-ORIGIN produits dans les réponses de liaison réussies sont dérivés de l'ensemble des liaisons actives.

Exemple

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

Retour aux méthodes