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

DatagramSocket オブジェクトをバインドするローカル ホスト名または IP アドレス。

localServiceName

String

Platform::String

winrt::hstring

DatagramSocket オブジェクトをバインドするローカル サービス名または UDP ポート。

戻り値

IAsyncAction

DatagramSocket オブジェクトに対する非同期バインド操作。

属性

RemoteAsyncAttribute

Windows の要件

アプリの機能

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

注釈

BindEndpointAsync メソッドは、localHostName パラメーターで指定されたローカル ホスト名または IP アドレス、および localServiceName パラメーターで指定されたローカル サービス名または UDP ポート番号アドレスに DatagramSocket をバインドします。 localHostName パラメーターが null の場合、システムはバインドするローカル IP アドレスを選択します。 localServiceName パラメーターが空の文字列の場合、バインドするローカル UDP ポートがシステムによって選択されます。

DatagramSocketControl.MulticastOnly プロパティを使用していない限り、UDP を使用する別のアプリ (たとえば、別の DatagramSocket) が localHostName パラメーターと localServiceName パラメーターで指定された UDP ポートに既にバインドされている場合、BindEndpointAsync メソッドは失敗します。

バインドは、 DatagramSocket 上の任意のリモート エンドポイントからデータを受信するために不可欠であり、通常、ソケットが作成され、 MessageReceived イベントが設定された後に行われます。 BindServiceNameAsync メソッドまたは BindEndpointAsync メソッドは、DatagramSocket をローカル サービス名または UDP ポートにバインドするために使用されます。 ソケットがまだバインドされていない場合は、 ConnectAsync メソッドでもバインド操作が行われます。 GetOutputStreamAsync メソッドの 1 つによって返されるストリームに書き込むと、バインド操作も行われます。

BindServiceNameAsync メソッドと BindEndpointAsync メソッドは、次の場合には必要ありません。

• DatagramSocket は、データの送信にのみ使用されます。
• DatagramSocket は、1 つのエンドポイントとの間でデータを送受信するために使用されます。

こちらもご覧ください

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived