StreamSocketListener.BindServiceNameAsync Método

Definición

Espacio de nombres:

Windows.Networking.Sockets

Sobrecargas

BindServiceNameAsync(String)	Inicia una operación de enlace en streamSocketListener en un nombre de servicio local.
BindServiceNameAsync(String, SocketProtectionLevel)	Inicia una operación de enlace en streamSocketListener en un nombre de servicio local con un socketProtectionLevel especificado para establecer en los sockets enlazados.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)	Inicia una operación de enlace de socket en streamSocketListener en un nombre de servicio local en un adaptador de red especificado con un socketProtectionLevel especificado para establecer en los sockets enlazados.

BindServiceNameAsync(String)

Inicia una operación de enlace en streamSocketListener 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 TCP en el que se va a enlazar el objeto StreamSocketListener . Para Bluetooth RFCOMM, este parámetro es el identificador del servicio Bluetooth.

Devoluciones

IAsyncAction

Operación de enlace asincrónica en un objeto StreamSocketListener .

Atributos

RemoteAsyncAttribute

Comentarios

El método BindServiceNameAsync(String) se enlaza a las direcciones IP locales de todas las interfaces de red del equipo local y al nombre del servicio local o al puerto TCP especificado en el parámetro localServiceName . Si el parámetro localServiceName es una cadena vacía, el sistema seleccionará el puerto TCP local en el que se va a enlazar.

En el caso de RFCOMM de Bluetooth, este método se enlaza al identificador de servicio bluetooth especificado en el parámetro localServiceName en todas las interfaces Bluetooth. Se debe proporcionar un identificador de servicio Bluetooth para enlazar para Bluetooth.

El método BindServiceNameAsync(String) producirá un error si otra aplicación (otro StreamSocketListener, por ejemplo) ya se ha enlazado al puerto TCP local o al identificador de servicio bluetooth especificado en el parámetro localServiceName .

Consulte también

• BindEndpointAsync(HostName, String)
• BindServiceNameAsync(String, SocketProtectionLevel)
• BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)
• StreamSocketListenerInformation

BindServiceNameAsync(String, SocketProtectionLevel)

Inicia una operación de enlace en streamSocketListener en un nombre de servicio local con un socketProtectionLevel especificado para establecer en los sockets enlazados.

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

/// [Windows.Foundation.Metadata.Overload("BindServiceNameWithProtectionLevelAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName, SocketProtectionLevel const& protectionLevel);

[Windows.Foundation.Metadata.Overload("BindServiceNameWithProtectionLevelAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName, SocketProtectionLevel protectionLevel);

function bindServiceNameAsync(localServiceName, protectionLevel)

Public Function BindServiceNameAsync (localServiceName As String, protectionLevel As SocketProtectionLevel) As IAsyncAction

Parámetros

localServiceName

String

Platform::String

winrt::hstring

Nombre del servicio local o puerto TCP en el que se va a enlazar el objeto StreamSocketListener . Para Bluetooth RFCOMM, este parámetro es el identificador del servicio Bluetooth.

protectionLevel

SocketProtectionLevel

Nivel de protección para el cifrado que se va a establecer en los sockets enlazados.

Devoluciones

IAsyncAction

Operación de enlace asincrónica en un objeto StreamSocketListener .

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

El método [BindServiceNameAsync(String, SocketProtectionLevel) se enlaza a las direcciones IP locales de todas las interfaces de red del equipo local y al nombre del servicio local o al puerto TCP especificado en el parámetro localServiceName . En el caso de RFCOMM de Bluetooth, este método se enlaza al identificador de servicio bluetooth especificado en el parámetro localServiceName en todas las interfaces Bluetooth. Este método establece el nivel de protección para el cifrado en los sockets enlazados al parámetro protectionLevel .

Si el parámetro localServiceName es una cadena vacía, el sistema seleccionará el puerto TCP local en el que se va a enlazar. Se debe proporcionar un identificador de servicio Bluetooth para enlazar para Bluetooth.

Se producirá un error en el método [BindServiceNameAsync(String, SocketProtectionLevel) si otra aplicación (otro StreamSocketListener, por ejemplo) ya se ha enlazado al puerto TCP local o al identificador de servicio Bluetooth especificado en el parámetro localServiceName .

El parámetro protectionLevel debe establecerse en PlainSocket para todos los sockets excepto los usados a través de Bluetooth. Cuando el socket se va a usar a través de Bluetooth, el parámetro protectionLevel se puede establecer en PlainSocket, BluetoothEncryptionAllowNullAuthentication o BluetoothEncryptionWithAuthentication. Para obtener más información, consulte la enumeración SocketProtectionLevel .

Consulte también

• BindEndpointAsync(HostName, String)
• BindServiceNameAsync(String)
• SocketProtectionLevel
• StreamSocketListenerInformation

BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

Inicia una operación de enlace de socket en streamSocketListener en un nombre de servicio local en un adaptador de red especificado con un socketProtectionLevel especificado para establecer en los sockets enlazados.

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

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

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

function bindServiceNameAsync(localServiceName, protectionLevel, adapter)

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

Parámetros

localServiceName

String

Platform::String

winrt::hstring

Nombre del servicio local o puerto TCP en el que se va a enlazar el objeto StreamSocketListener . Para Bluetooth RFCOMM, este parámetro es el identificador del servicio Bluetooth.

protectionLevel

SocketProtectionLevel

Nivel de protección para el cifrado que se va a establecer en los sockets enlazados.

adapter

NetworkAdapter

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

Devoluciones

IAsyncAction

Operación de enlace asincrónica en un objeto StreamSocketListener .

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentarios

El método [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) se enlaza al nombre del servicio local o al puerto TCP especificado en el parámetro localServiceName del adaptador de red especificado en el parámetro adapter en el equipo local. Para Bluetooth RFCOMM, este método se enlaza al identificador de servicio bluetooth especificado en el parámetro localServiceName si el parámetro del adaptador es null. Se debe proporcionar un identificador de servicio Bluetooth para enlazar para Bluetooth. Si se especifica un adaptador de red en el parámetro adapter y el parámetro localServiceName contiene un identificador de servicio Bluetooth, se producirá un error en este método.

Este método establece el nivel de protección para el cifrado en los sockets enlazados al parámetro protectionLevel .

Si el parámetro localServiceName es una cadena vacía, el sistema seleccionará el puerto TCP local en el que se va a enlazar. Si el parámetro del adaptador es null para un enlace de socket TCP, se producirá un error.

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

Se producirá un error en el método [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) si otra aplicación (otro StreamSocketListener, por ejemplo) ya se ha enlazado al puerto TCP local especificado en el parámetro localServiceName del adaptador de red especificado en el parámetro adapter . Para Bluetooth, este método producirá un error si otra aplicación (otro StreamSocketListener, por ejemplo) ya se ha enlazado al identificador de servicio bluetooth especificado en el parámetro localServiceName .

El uso del adaptador de red especificado se basa en el mejor esfuerzo. Un sistema con adaptadores configurados en modos de reenvío o host débil puede usar un adaptador distinto del adaptador especificado.

El parámetro protectionLevel debe establecerse en PlainSocket para todos los sockets excepto los usados a través de Bluetooth. Cuando el socket se va a usar a través de Bluetooth, el parámetro protectionLevel se puede establecer en PlainSocket, BluetoothEncryptionAllowNullAuthentication o BluetoothEncryptionWithAuthentication. Para obtener más información, consulte la enumeración SocketProtectionLevel .

Consulte también

• BindServiceNameAsync(String)
• BindServiceNameAsync(String, SocketProtectionLevel)
• SocketProtectionLevel
• StreamSocketListenerInformation