DatagramSocket.BindServiceNameAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 IAsyncActionPará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
Una operación de enlace asincrónica en un objeto DatagramSocket .
- Atributos
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
Se aplica a
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 IAsyncActionPará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
Una operación de enlace asincrónica en un objeto DatagramSocket .
- Atributos
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.