DatagramSocket.BindEndpointAsync(HostName, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 ポート。
戻り値
DatagramSocket オブジェクトに対する非同期バインド操作。
- 属性
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 つのエンドポイントとの間でデータを送受信するために使用されます。