Language

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 の要件

要件 説明
アプリの機能
internetClientServer privateNetworkClientServer

注釈

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

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

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

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

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

適用対象

関連項目