UdpAnySourceMulticastClient.BeginSendTo メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
注意事項
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
指定した宛先にユニキャスト パケットを送信する操作を開始します。
public:
IAsyncResult ^ BeginSendTo(cli::array <System::Byte> ^ buffer, int offset, int count, System::Net::IPEndPoint ^ remoteEndPoint, AsyncCallback ^ callback, System::Object ^ state);
[System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)]
public IAsyncResult BeginSendTo(byte[] buffer, int offset, int count, System.Net.IPEndPoint remoteEndPoint, AsyncCallback callback, object state);
[<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>]
member this.BeginSendTo : byte[] * int * int * System.Net.IPEndPoint * AsyncCallback * obj -> IAsyncResult
Public Function BeginSendTo (buffer As Byte(), offset As Integer, count As Integer, remoteEndPoint As IPEndPoint, callback As AsyncCallback, state As Object) As IAsyncResult
パラメーター
- buffer
- Byte[]
送信するデータが格納されているバッファー。
- offset
- Int32
送信するデータを読み取る buffer
の先頭からのバイト単位のオフセット。
- count
- Int32
buffer
から送信するバイト数。
- remoteEndPoint
- IPEndPoint
パケットを送信するリモート エンドポイント。
- callback
- AsyncCallback
操作の完了時に呼び出されるコールバック メソッド。
- state
- Object
この操作の callback
メソッドに渡す省略可能な状態情報。
戻り値
この操作を参照する IAsyncResult。
- 属性
例外
buffer
が null 参照 (Visual Basic では Nothing) です。
offset
が 0 未満です。
- または -
offset
が buffer
の長さを超えています。
- または -
count
が 0 未満です。
- または -
offset
にカウントを加算した値が buffer
の長さを超えています。
マルチキャスト グループにまだ参加していません。
ソケットへのアクセスを試行しているときにエラーが発生しました。
注釈
メソッドは BeginSendTo 、参加しているマルチキャスト グループに UDP パケットを送信する操作を開始します。
クライアントがマルチキャスト グループへの参加を完了している必要があります。 パラメーターで remoteEndPoint
指定された宛先アドレスは、この受信側にマルチキャスト パケットを既に送信している必要があります。 一部のプロトコルでは、この情報を使用して、フロー制御、サービスの品質統計、または回復メッセージを渡します。
パラメーターで callback
指定されたメソッドは、パケットが受信されたときに呼び出されます。
送信は、 パラメーターで指定されたアドレスがこの受信側に remoteEndPoint
マルチキャスト パケットを既に送信している場合にのみ許可されます。 クライアントがアクセスを許可されていない場合は、 SocketException を使用して AccessDeniedがスローされます。
パラメーターで remoteEndPoint
指定された宛先ポートが 1,024 未満の場合は、 SocketException を指定して AccessDeniedがスローされます。
受信操作が同期的に失敗した場合、ソケットエラーが発生する可能性がありますが、これは UDP では一般的ではありません。 ソケットエラーが発生した場合は、 SocketException がスローされます。 受け取ったエラーは、 列挙体の SocketError メンバーとして指定されます。