エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

DatagramSocket.BindEndpointAsync | bindEndpointAsync Method

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

構文


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

パラメーター

localHostName

型: HostName

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

localServiceName

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

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

戻り値

型: IAsyncAction

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

解説

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

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

束縛は 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]

参照

BindServiceNameAsync
DatagramSocket
DatagramSocketInformation
MessageReceived

 

 

表示:
© 2014 Microsoft