TsgcUDPServer › Métodos › AddBinding
Añade un nuevo endpoint de escucha (IP/puerto) al servidor sin reiniciar los enlaces actualmente activos.
TIdSocketHandle * __fastcall AddBinding(const UnicodeString aIPAddress, int aPort, const UnicodeString aName = '');
| Nombre | Tipo | Descripción |
|---|---|---|
aIPAddress | const string | Dirección IPv4/IPv6 local a la que enlazarse. Use una cadena vacía, 0.0.0.0 o :: para enlazarse a todas las interfaces. |
aPort | Integer | Número de puerto UDP local (de 1 a 65535). Use 0 para solicitar un puerto efímero al sistema operativo. |
aName | const string | Nombre descriptivo opcional utilizado por la compilación personalizada de Indy para etiquetar el hilo del listener; pase una cadena vacía para aceptar el valor predeterminado. |
El TIdSocketHandle recién creado (o el existente si ya hay una entrada para aIPAddress/aPort). El manejador es propiedad de la colección Bindings y no debe ser liberado por el llamador. (TIdSocketHandle)
AddBinding agrega una nueva entrada a Bindings, asigna su socket de datagramas, enlaza el socket y genera el hilo de escucha sin detener ningún otro binding ya gestionado por el componente. Esto permite que el servidor comience a escuchar en una IP/puerto adicional en tiempo de ejecución (por ejemplo, para activar endpoints IPv4 e IPv6, o para agregar una nueva interfaz cuando esté disponible). Si ya existe un binding con la misma IP y puerto, se devuelve sin cambios y no se abre ningún socket nuevo. El método requiere Indy 10.2 o posterior y genera una excepción en versiones anteriores.