UdpSingleSourceMulticastClient.BeginJoinGroup(AsyncCallback, Object) Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.dll

Przestroga

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

Wiąże gniazdo i rozpoczyna operację sprzężenia do grupy multiemisji, aby umożliwić odbieranie datagramów z jednego adresu źródłowego.

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

Parametry

callback

AsyncCallback

Metoda wywołania zwrotnego, która ma być wywoływana po zakończeniu operacji.

state

Object

Opcjonalne informacje o stanie, które mają być przekazywane do callback metody dla tej operacji.

Zwraca

IAsyncResult

Obiekt IAsyncResult , który odwołuje się do tej operacji.

Atrybuty

ObsoleteAttribute

Wyjątki

InvalidOperationException

Grupa multiemisji została już dołączona lub trwa operacja sprzężenia.

ObjectDisposedException

Został UdpSingleSourceMulticastClient usunięty.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

Uwagi

Metoda BeginJoinGroup wiąże gniazdo multiemisji UDP z portem lokalnym i łączy grupę multiemisji, aby umożliwić odbieranie datagramów z jednego adresu źródłowego. Adres grupy multiemisji, pojedynczy adres źródłowy i port lokalny do powiązania są określone w konstruktorze UdpSingleSourceMulticastClient .

Metoda określona w parametrze callback jest wywoływana, gdy operacja dołączenia do grupy multiemisji została ukończona.

Jeśli jest to wymagane przez środowisko uruchomieniowe, metoda wykonuje również kontrolę zasad w BeginJoinGroup celu sprawdzenia, czy klient może uzyskać dostęp do grupy multiemisji. Jeśli klient nie ma dozwolonego dostępu, SocketException zostanie zgłoszony za pomocą polecenia AccessDenied.