UdpAnySourceMulticastClient.BeginReceiveFromGroup メソッド

定義

注意事項

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

参加しているマルチキャスト グループからのパケットの受信操作を開始し、任意の送信元からのパケットがマルチキャスト グループに到着したら、指定されたコールバックを呼び出します。

public:
 IAsyncResult ^ BeginReceiveFromGroup(cli::array <System::Byte> ^ buffer, int offset, int count, 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 BeginReceiveFromGroup (byte[] buffer, int offset, int count, 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.BeginReceiveFromGroup : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginReceiveFromGroup (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

buffer
Byte[]

受信したデータを格納するバッファー。

offset
Int32

データの保存先になる、buffer の先頭からのバイト単位のオフセット。

count
Int32

buffer で受信および格納するバイトの最大数。

callback
AsyncCallback

操作の完了時に呼び出されるコールバック メソッド。

state
Object

この操作の callback メソッドに渡す省略可能な状態情報。

戻り値

この操作を参照する IAsyncResult

属性

例外

buffer が null 参照 (Visual Basic では Nothing) です。

offset が 0 未満です。

- または -

offsetbuffer の長さを超えています。

- または -

count が 0 未満です。

- または -

offset にカウントを加算した値が buffer の長さを超えています。

マルチキャスト グループにまだ参加していません。

UdpAnySourceMulticastClient は破棄されています。

ソケットへのアクセスを試行しているときにエラーが発生しました。

注釈

メソッドは BeginReceiveFromGroup 、任意の送信者から参加しているマルチキャスト グループから UDP パケットを受信する操作を開始します。 ローカル ポートとマルチキャスト グループ アドレスは、コンストラクターで UdpAnySourceMulticastClient 指定されます。 マルチキャスト クライアントは、マルチキャスト グループへの参加も完了している必要があります。

パラメーターで callback 指定されたメソッドは、パケットが受信されたときに呼び出されます。

受信操作が同期的に失敗した場合、ソケットエラーが発生する可能性がありますが、これは UDP では一般的ではありません。 ソケットエラーが発生した場合は、 SocketException がスローされます。 受け取ったエラーは、 列挙体の SocketError メンバーとして指定されます。

適用対象