DatagramSocket.BindServiceNameAsync Método

Definición

Espacio de nombres:

Windows.Networking.Sockets

Sobrecargas

BindServiceNameAsync(String)	Inicia una operación de enlace en un DatagramSocket en un nombre de servicio local.
BindServiceNameAsync(String, NetworkAdapter)	Inicia una operación de enlace en un DatagramSocket en un nombre de servicio local y una interfaz de red específica.

BindServiceNameAsync(String)

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

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

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 BindServiceNameAsync se enlaza a las direcciones IP locales de todas las interfaces de red del equipo local en el nombre del servicio local o 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 , se producirá un error en el método BindServiceNameAsync si otra aplicación que usa UDP (por ejemplo, otro DatagramSocket) ya está enlazada 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 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 a un puerto UDP. Los métodos ConnectAsync también darán como resultado una operación de enlace. Escribir en una secuencia devuelta por uno de los métodos GetOutputStreamAsync también dará como resultado 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:

• 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

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

BindServiceNameAsync(String, NetworkAdapter)

Inicia una operación de enlace en un DatagramSocket en un nombre de servicio local y una interfaz de red específica.

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

localServiceName

String

Platform::String

winrt::hstring

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

adapter

NetworkAdapter

Adaptador de red en el que se va a enlazar el objeto DatagramSocket .

Devoluciones

IAsyncAction

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 y el nombre del servicio local o el puerto UDP especificado en el parámetro localServiceName del 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 del adaptador 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 (por ejemplo, otro DatagramSocket) 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 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 a un puerto UDP. Los métodos ConnectAsync también darán lugar a una operación de enlace, pero no se pueden limitar a un adaptador de red específico. La escritura en una secuencia devuelta por uno de los métodos 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:

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

Si se usa el método [BindServiceNameAsync(String, NetworkAdapter), la operación de enlace limitará los paquetes de multidifusión y unidifusión entrantes y salientes 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