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.

绑定套接字并开始多播组的联接操作，以便允许接收来自单个源地址的数据报。

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引发 。