情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

DatagramSocket.BindServiceNameAsync(String) | bindServiceNameAsync(String) Method

DatagramSocket でローカル サービス名に対してバインド操作を開始します。

構文


datagramSocket.bindServiceNameAsync(localServiceName).done( /* 成功ハンドラーとエラー ハンドラー */ );

パラメーター

localServiceName

型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

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

戻り値

型: IAsyncAction

DatagramSocket のオブジェクトの非同期バインディング操作です。

解説

BindServiceNameAsync メソッドは、localServiceName パラメーターで指定されているローカル サービス名または UDP ポート上のローカル コンピューターで、全ネットワーク インターフェイスのローカル IP アドレスにバインドします。localServiceName パラメーターが空の文字列の場合、システムによって束縛するローカル UDP ポートが選択されます。

UDP を使用する別のアプリケーション (別の DatagramSocket など) が localServiceName パラメーターで指定されているローカル UDP ポートに既にバインドされている場合、BindServiceNameAsync メソッドは失敗します。

束縛は DatagramSocket でデータを取得する場合に不可欠であり、ソケットを作成して MessageReceived イベントを設定した後に実行されるのが一般的です。BindServiceNameAsync メソッドまたは BindEndpointAsync メソッドは、DatagramSocket をローカル サービス名または UDP ポートにバインドするときに使用されます。ConnectAsync メソッドもバインド操作になります。いずれかの GetOutputStreamAsync メソッドによって返されるストリームに書き込んだ場合も、ソケットが既に束縛されていないと、束縛操作になります。

DatagramSocket がデータを送信するためにのみ使用される場合は、BindServiceNameAsync または BindEndpointAsync メソッドは必要ありません。

要件

最小限サポートされるクライアント

Windows 8

最小限サポートされるサーバー

Windows Server 2012

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

メタデータ

Windows.winmd

DLL

Windows.Networking.dll

Capabilities

internetClientServer
privateNetworkClientServer
ID_CAP_NETWORKING [Windows Phone]

参照

DatagramSocket
BindEndpointAsync
BindServiceNameAsync(String, NetworkAdapter)
DatagramSocketInformation

 

 

表示: