TsgcUDPServerMétodos › AddBinding

AddBinding Método

Añade un nuevo endpoint de escucha (IP/puerto) al servidor sin reiniciar los enlaces actualmente activos.

Sintaxis

TIdSocketHandle * __fastcall AddBinding(const UnicodeString aIPAddress, int aPort, const UnicodeString aName = '');

Parámetros

NombreTipoDescripción
aIPAddressconst stringDirección IPv4/IPv6 local a la que enlazarse. Use una cadena vacía, 0.0.0.0 o :: para enlazarse a todas las interfaces.
aPortIntegerNúmero de puerto UDP local (de 1 a 65535). Use 0 para solicitar un puerto efímero al sistema operativo.
aNameconst stringNombre 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.

Valor de Retorno

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)

Observaciones

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.

Ejemplo

Volver a Métodos