StreamSocketListener.BindEndpointAsync(HostName, String) Método

Definição

Namespace:

Windows.Networking.Sockets

Inicia uma operação de associação em um StreamSocketListener a um nome de host local e um nome de serviço local.

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);

function bindEndpointAsync(localHostName, localServiceName)

Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

Parâmetros

localHostName

HostName

O nome do host local ou o endereço IP no qual associar o objeto StreamSocketListener .

localServiceName

String

Platform::String

winrt::hstring

O nome do serviço local ou a porta TCP na qual associar o objeto StreamSocketListener .

Retornos

IAsyncAction

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

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Comentários

O método BindEndpointAsync associa um objeto StreamSocketListener a um nome de host ou endereço IP específico especificado no parâmetro localHostName e o nome do serviço local ou a porta TCP especificada no parâmetro localServiceName . Se o parâmetro localHostName for nulo, o sistema selecionará o endereço IP local a ser associado ao objeto StreamSocketListener . Se o parâmetro localServiceName contiver uma cadeia de caracteres vazia, o sistema selecionará a porta TCP local para associar ao objeto StreamSocketListener .

O método BindEndpointAsync falhará se outro aplicativo usando TCP (outro StreamSocketListener, por exemplo) já tiver sido associado ao endereço IP local e à porta TCP especificada nos parâmetros localHostName e localServiceName .

Confira também

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