UdpSingleSourceMulticastClient.BeginJoinGroup(AsyncCallback, Object) Methode

Definition

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

Ein IAsyncResult, das auf diesen Vorgang verweist.

Attribute

Ausnahmen

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

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.

Gilt für: