DatagramSocket.BindEndpointAsync(HostName, String) Метод

Определение

Пространство имен:

Windows.Networking.Sockets

Запускает операцию привязки datagramSocket к локальному имени узла и имени локальной службы.

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

Параметры

localHostName

HostName

Локальное имя узла или IP-адрес, по которому необходимо привязать объект DatagramSocket .

localServiceName

String

Platform::String

winrt::hstring

Имя локальной службы или UDP-порт, к которому необходимо привязать объект DatagramSocket .

Возвращаемое значение

IAsyncAction

Асинхронная операция привязки для объекта DatagramSocket .

Атрибуты

RemoteAsyncAttribute

Требования к Windows

Возможности приложения

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Комментарии

Метод BindEndpointAsync привязывает DatagramSocket к локальному имени узла или IP-адресу, указанному в параметре localHostName , и имени локальной службы или адресу номера порта UDP, указанному в параметре localServiceName . Если параметр localHostName имеет значение NULL, система выберет локальный IP-адрес для привязки. Если параметр localServiceName является пустой строкой, система выберет локальный UDP-порт, к которому требуется выполнить привязку.

Если вы не использовали свойство DatagramSocketControl.MulticastOnly , метод BindEndpointAsync завершится ошибкой, если другое приложение, использующее UDP (например, другое datagramSocket), уже привязано к локальному IP-адресу и порту UDP, указанным в параметрах localHostName и localServiceName .

Привязка необходима для получения данных из любой удаленной конечной точки в DatagramSocket и обычно выполняется после создания сокета и установки события MessageReceived . Метод BindServiceNameAsync или BindEndpointAsync используется для привязки DatagramSocket к имени локальной службы или порту UDP. Методы ConnectAsync также приводят к операции привязки, если сокет еще не привязан. Запись в поток, возвращаемый одним из методов GetOutputStreamAsync , также приведет к операции привязки.

Методы BindServiceNameAsync и BindEndpointAsync не требуются в следующих случаях:

• DatagramSocket используется только для отправки данных.
• DatagramSocket используется для отправки данных в одну конечную точку и получения данных из нее.

См. также раздел

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived