UdpSingleSourceMulticastClient.BeginJoinGroup(AsyncCallback, Object) メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.dll

注意事項

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

ソケットをバインドし、マルチキャスト グループへの結合操作を開始して、1 つのソース アドレスからデータグラムを受信できるようにします。

public:
 IAsyncResult ^ BeginJoinGroup(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 BeginJoinGroup(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.BeginJoinGroup : AsyncCallback * obj -> IAsyncResult

Public Function BeginJoinGroup (callback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

callback

AsyncCallback

操作が完了したときに呼び出すコールバック メソッド。

state

Object

この操作の callback メソッドに渡すオプションの状態情報。

返品

IAsyncResult

この操作を参照する IAsyncResult 。

属性

ObsoleteAttribute

例外

InvalidOperationException

マルチキャスト グループは既に参加しているか、現在参加操作が進行中です。

ObjectDisposedException

UdpSingleSourceMulticastClientが破棄されました。

SocketException

ソケットにアクセスしようとしたときにエラーが発生しました。

注釈

BeginJoinGroupメソッドは、UDP マルチキャスト ソケットをローカル ポートにバインドし、マルチキャスト グループを結合して、単一のソース アドレスからデータグラムを受信できるようにします。 バインド先のマルチキャスト グループ アドレス、単一ソース アドレス、およびローカル ポートは、 UdpSingleSourceMulticastClient コンストラクターで指定されます。

callback パラメーターで指定されたメソッドは、マルチキャスト グループに参加する操作が完了したときに呼び出されます。

ランタイムで必要な場合、 BeginJoinGroup メソッドは、クライアントがマルチキャスト グループへのアクセスを許可されていることを確認するポリシー チェックも実行します。 クライアントがアクセスを許可されていない場合は、SocketExceptionを使用してAccessDeniedがスローされます。