StreamSocketListener.BindServiceNameAsync Método

Definição

Namespace:

Windows.Networking.Sockets

Sobrecargas

BindServiceNameAsync(String)	Inicia uma operação de associação em um StreamSocketListener para um nome de serviço local.
BindServiceNameAsync(String, SocketProtectionLevel)	Inicia uma operação de associação em um StreamSocketListener para um nome de serviço local com um SocketProtectionLevel especificado para definir em qualquer soquete associado.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)	Inicia uma operação de associação de soquete em um StreamSocketListener para um nome de serviço local em um adaptador de rede especificado com um SocketProtectionLevel especificado para definir em quaisquer soquetes associados.

BindServiceNameAsync(String)

Inicia uma operação de associação em um StreamSocketListener para um nome de serviço 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

O nome do serviço local ou a porta TCP na qual associar o objeto StreamSocketListener . Para Bluetooth RFCOMM, esse parâmetro é a ID do Serviço Bluetooth.

Retornos

IAsyncAction

A operação de associação assíncrona em um objeto StreamSocketListener .

Atributos

RemoteAsyncAttribute

Comentários

O método BindServiceNameAsync(String) associa-se aos endereços IP locais de todos os adaptadores de rede no computador local e ao nome do serviço local ou à porta TCP especificada no parâmetro localServiceName . Se o parâmetro localServiceName for uma cadeia de caracteres vazia, o sistema selecionará a porta TCP local na qual associar.

Para Bluetooth RFCOMM, esse método se associa à ID do Serviço Bluetooth especificada no parâmetro localServiceName em todas as interfaces Bluetooth. Uma ID de Serviço Bluetooth deve ser fornecida para associar para Bluetooth.

O método BindServiceNameAsync(String) falhará se outro aplicativo (outro StreamSocketListener, por exemplo) já tiver sido associado à porta TCP local ou à ID do Serviço Bluetooth especificada no parâmetro localServiceName .

Confira também

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

BindServiceNameAsync(String, SocketProtectionLevel)

Inicia uma operação de associação em um StreamSocketListener para um nome de serviço local com um SocketProtectionLevel especificado para definir em qualquer soquete associado.

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

O nome do serviço local ou a porta TCP na qual associar o objeto StreamSocketListener . Para Bluetooth RFCOMM, esse parâmetro é a ID do Serviço Bluetooth.

protectionLevel

SocketProtectionLevel

O nível de proteção para criptografia a ser definido em qualquer soquete associado.

Retornos

IAsyncAction

A operação de associação assíncrona em um objeto StreamSocketListener .

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentários

O método [BindServiceNameAsync(String, SocketProtectionLevel) associa-se aos endereços IP locais de todos os adaptadores de rede no computador local e ao nome do serviço local ou à porta TCP especificada no parâmetro localServiceName . Para Bluetooth RFCOMM, esse método se associa à ID do Serviço Bluetooth especificada no parâmetro localServiceName em todas as interfaces Bluetooth. Esse método define o nível de proteção para criptografia em qualquer soquete associado para o parâmetro protectionLevel .

Se o parâmetro localServiceName for uma cadeia de caracteres vazia, o sistema selecionará a porta TCP local na qual associar. Uma ID de Serviço Bluetooth deve ser fornecida para associar para Bluetooth.

O método [BindServiceNameAsync(String, SocketProtectionLevel) falhará se outro aplicativo (outro StreamSocketListener, por exemplo) já tiver sido associado à porta TCP local ou à ID do Serviço Bluetooth especificada no parâmetro localServiceName .

O parâmetro protectionLevel deve ser definido como PlainSocket para todos os soquetes, exceto aqueles usados por Bluetooth. Quando o soquete deve ser usado por Bluetooth, o parâmetro protectionLevel pode ser definido como PlainSocket, BluetoothEncryptionAllowNullAuthentication ou BluetoothEncryptionWithAuthentication. Para obter mais informações, consulte a enumeração SocketProtectionLevel .

Confira também

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

BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

Inicia uma operação de associação de soquete em um StreamSocketListener para um nome de serviço local em um adaptador de rede especificado com um SocketProtectionLevel especificado para definir em quaisquer soquetes associados.

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

O nome do serviço local ou a porta TCP na qual associar o objeto StreamSocketListener . Para Bluetooth RFCOMM, esse parâmetro é a ID do Serviço Bluetooth.

protectionLevel

SocketProtectionLevel

O nível de proteção para criptografia a ser definido em qualquer soquete associado.

adapter

NetworkAdapter

O adaptador de rede no qual associar o objeto StreamSocketListener .

Retornos

IAsyncAction

A operação de associação assíncrona em um objeto StreamSocketListener .

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentários

O método [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) é associado ao nome do serviço local ou à porta TCP especificada no parâmetro localServiceName no adaptador de rede especificado no parâmetro adapter no computador local. Para Bluetooth RFCOMM, esse método se associa à ID do Serviço Bluetooth especificada no parâmetro localServiceName se o parâmetro do adaptador for nulo. Uma ID de Serviço Bluetooth deve ser fornecida para associar para Bluetooth. Se um adaptador de rede for especificado no parâmetro do adaptador e o parâmetro localServiceName contiver uma ID de Serviço Bluetooth, esse método falhará.

Esse método define o nível de proteção para criptografia em qualquer soquete associado para o parâmetro protectionLevel .

Se o parâmetro localServiceName for uma cadeia de caracteres vazia, o sistema selecionará a porta TCP local na qual associar. Se o parâmetro do adaptador for nulo para uma associação de soquete TCP, ocorrerá um erro.

O mecanismo de resolução de nomes usado pelo método [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) é limitado à interface especificada para o namespace do DNS (sistema de nomes de domínio).

O método [BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) falhará se outro aplicativo (outro StreamSocketListener, por exemplo) já tiver sido associado à porta TCP local especificada no parâmetro localServiceName no adaptador de rede especificado no parâmetro adapter . Para Bluetooth, esse método falhará se outro aplicativo (outro StreamSocketListener, por exemplo) já tiver sido associado à ID do Serviço Bluetooth especificada no parâmetro localServiceName .

O uso do adaptador de rede especificado é uma base de melhor esforço. Um sistema com adaptadores configurados em modos de host fraco ou encaminhamento pode usar um adaptador diferente do adaptador especificado.

O parâmetro protectionLevel deve ser definido como PlainSocket para todos os soquetes, exceto aqueles usados por Bluetooth. Quando o soquete deve ser usado por Bluetooth, o parâmetro protectionLevel pode ser definido como PlainSocket, BluetoothEncryptionAllowNullAuthentication ou BluetoothEncryptionWithAuthentication. Para obter mais informações, consulte a enumeração SocketProtectionLevel .

Confira também

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