StreamSocketListener.BindServiceNameAsync Método

Definição

Namespace:: Windows.Networking.Sockets

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

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

BindServiceNameAsync(String)

Editar

Inicia uma operação de associação em um StreamSocketListener a 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 do 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

Aplica-se a

BindServiceNameAsync(String, SocketProtectionLevel)

Editar

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

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 a criptografia a ser definida em quaisquer soquetes associados.

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 quaisquer soquetes associados ao 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 do 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

Aplica-se a

BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter)

Editar

Inicia uma operação de associação de soquete em um StreamSocketListener a 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 a criptografia a ser definida em quaisquer soquetes associados.

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) associa-se ao nome do serviço local ou à porta TCP especificada no parâmetro localServiceName no adaptador de rede especificado no parâmetro do adaptador 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 do 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 quaisquer soquetes associados ao 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 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 do adaptador de rede . 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 .

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

Confira também

Aplica-se a

Comentários

Esta página foi útil?