UdpSingleSourceMulticastClient.BeginJoinGroup(AsyncCallback, Object) Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.dll

Achtung

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

Bindet den Socket und beginnt mit einem Beitrittsvorgang für die Multicastgruppe, damit Datagramme von einer einzelnen Quelladresse empfangen werden können.

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

Parameter

callback

AsyncCallback

Eine Rückrufmethode, die beim Abschließen des Vorgangs aufgerufen werden soll.

state

Object

Optionale Zustandsinformationen, die an die callback-Methode für diesen Vorgang übergeben werden sollen.

Gibt zurück

IAsyncResult

Ein IAsyncResult, das auf diesen Vorgang verweist.

Attribute

ObsoleteAttribute

Ausnahmen

InvalidOperationException

Die Multicastgruppe wurde bereits zusammengeführt, oder ein Beitrittsvorgang wird derzeit ausgeführt.

ObjectDisposedException

UdpSingleSourceMulticastClient wurde verworfen.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

Hinweise

Die BeginJoinGroup -Methode bindet einen UDP-Multicastsocket an einen lokalen Port und verknüpft eine Multicastgruppe, damit Datagramme von einer einzelnen Quelladresse empfangen werden können. Die Multicastgruppenadresse, die einzelne Quelladresse und der lokale Port, an den gebunden werden soll, werden im UdpSingleSourceMulticastClient Konstruktor angegeben.

Die im callback Parameter angegebene Methode wird aufgerufen, wenn der Vorgang zum Verknüpfen der Multicastgruppe abgeschlossen ist.

Falls für die Laufzeit erforderlich, führt die BeginJoinGroup Methode auch eine Richtlinienüberprüfung durch, um zu überprüfen, ob der Client auf die Multicastgruppe zugreifen darf. Wenn dem Client der Zugriff nicht gestattet ist, wird ein SocketException mit AccessDeniedausgelöst.