DatagramSocket.BindEndpointAsync(HostName, String) Método

Definición

Espacio de nombres:

Windows.Networking.Sockets

Inicia una operación de enlace en un DatagramSocket en un nombre de host local y un nombre de servicio local.

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);

function bindEndpointAsync(localHostName, localServiceName)

Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

Parámetros

localHostName

HostName

Nombre de host local o dirección IP en la que se va a enlazar el objeto DatagramSocket .

localServiceName

String

Platform::String

winrt::hstring

Nombre del servicio local o puerto UDP en el que se va a enlazar el objeto DatagramSocket .

Devoluciones

IAsyncAction

Una operación de enlace asincrónica en un objeto DatagramSocket .

Atributos

RemoteAsyncAttribute

Requisitos de Windows

Características de aplicaciones

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Comentarios

El método BindEndpointAsync enlaza datagramSocket con el nombre de host local o la dirección IP especificada en el parámetro localHostName y el nombre del servicio local o la dirección de número de puerto UDP especificada en el parámetro localServiceName . Si el parámetro localHostName es null, el sistema seleccionará la dirección IP local en la que se va a enlazar. Si el parámetro localServiceName es una cadena vacía, el sistema seleccionará el puerto UDP local en el que se va a enlazar.

A menos que haya usado la propiedad DatagramSocketControl.MulticastOnly , se producirá un error en el método BindEndpointAsync si otra aplicación que usa UDP (por ejemplo, otro DatagramSocket) ya está enlazada a la dirección IP local y al puerto UDP especificado en los parámetros localHostName y localServiceName .

El enlace es esencial para recibir datos de cualquier punto de conexión remoto en un DatagramSocket, y normalmente se realiza después de crear un socket y se ha establecido el evento MessageReceived . El método BindServiceNameAsync o BindEndpointAsync se usa para enlazar un DatagramSocket a un nombre de servicio local o un puerto UDP. Los métodos ConnectAsync también darán lugar a una operación de enlace si el socket aún no está enlazado. Escribir en una secuencia devuelta por uno de los métodos GetOutputStreamAsync también dará como resultado una operación de enlace.

Los métodos BindServiceNameAsync y BindEndpointAsync no son necesarios en los casos siguientes:

• DatagramSocket solo se usa para enviar datos.
• DatagramSocket se usa para enviar y recibir datos de un único punto de conexión.

Consulte también

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived