DatagramSocket.BindServiceNameAsync Método

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName);

function bindServiceNameAsync(localServiceName)

Public Function BindServiceNameAsync (localServiceName As String) As IAsyncAction

Parámetros

Devoluciones

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

Atributos

RemoteAsyncAttribute

Requisitos de Windows

Comentarios

El método BindServiceNameAsync enlaza a las direcciones IP locales de todas las interfaces de red del equipo local en el nombre del servicio local o en el puerto UDP especificado en el parámetro localServiceName . 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, el método BindServiceNameAsync producirá un error si otra aplicación que usa UDP (otra DatagramSocket, por ejemplo) ya se ha enlazado al puerto UDP local especificado en el parámetro 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 el evento MessageReceived se ha establecido. El BindServiceNameAsync o método bindEndpointAsync se usa para enlazar un DatagramSocket a un nombre de servicio local o puerto UDP. Los métodos connectAsync también darán lugar a una operación de enlace. Escribir en una secuencia devuelta por uno de los métodos de GetOutputStreamAsync también producirá una operación de enlace si el socket aún no está enlazado.

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

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

Consulte también

• BindEndpointAsync(HostName, String)
• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName, NetworkAdapter ^ adapter) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName, NetworkAdapter const& adapter);

[Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName, NetworkAdapter adapter);

function bindServiceNameAsync(localServiceName, adapter)

Public Function BindServiceNameAsync (localServiceName As String, adapter As NetworkAdapter) As IAsyncAction

Parámetros

Devoluciones

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

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

El método [BindServiceNameAsync(String, NetworkAdapter) se enlaza a una interfaz de red especificada en el parámetro del adaptador de y el nombre del servicio local o el puerto UDP especificados en el parámetro localServiceName en el equipo local. Si el parámetro localServiceName es una cadena vacía, el sistema seleccionará el puerto UDP local en el que se va a enlazar. Si el parámetro es NULL, se producirá un error.

El mecanismo de resolución de nombres utilizado por el método [BindServiceNameAsync(String, NetworkAdapter) se limita a la interfaz especificada para el espacio de nombres del sistema de nombres de dominio (DNS).

A menos que haya usado la propiedad DatagramSocketControl.MulticastOnly, se producirá un error en el método BindServiceNameAsync si otra aplicación que usa UDP (otra DatagramSocket, por ejemplo) ya se ha enlazado al puerto UDP local especificado en el parámetro localServiceName en la misma interfaz de red.

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 el evento MessageReceived se ha establecido. El método BindServiceNameAsync o BindEndpointAsync se usa para enlazar un DatagramSocket a un nombre de servicio local o puerto UDP. Los métodos connectAsync de también darán lugar a una operación de enlace, pero no se pueden limitar a un adaptador de red específico. Escribir en una secuencia devuelta por uno de los métodos de GetOutputStreamAsync también dará lugar a una operación de enlace si el socket aún no está enlazado, pero no se puede limitar a un adaptador de red específico.

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

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

Si se usa el método [BindServiceNameAsync(String, NetworkAdapter), la operación de enlace limitará la multidifusión entrante y saliente y los paquetes de unidifusión al adaptador especificado.

El uso del adaptador de red especificado es lo mejor posible. Entre otras configuraciones, los sistemas con adaptadores configurados en modos de reenvío o host débil pueden usar un adaptador distinto del adaptador especificado.

Consulte también

• BindServiceNameAsync(String)
• BindEndpointAsync(HostName, String)
• DatagramSocketInformation