UdpAnySourceMulticastClient.BeginReceiveFromGroup Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Achtung
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Startet das Empfangen eines Pakets von einer verknüpften Multicastgruppe und ruft den angegebenen Rückruf auf, wenn ein Paket von einem irgendeinem Absender in der Gruppe angekommen ist.
public:
IAsyncResult ^ BeginReceiveFromGroup(cli::array <System::Byte> ^ buffer, int offset, int count, 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 BeginReceiveFromGroup (byte[] buffer, int offset, int count, 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.BeginReceiveFromGroup : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginReceiveFromGroup (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult
Parameter
- buffer
- Byte[]
Der Puffer zum Speichern der empfangenen Daten.
- offset
- Int32
Der Offset, in Bytes, ab dem Anfang des buffer
s, in dem die Daten gespeichert werden sollen.
- count
- Int32
Die maximale Anzahl der zu empfangenden und im buffer
zu speichernden Bytes.
- callback
- AsyncCallback
Die 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
buffer
ist ein NULL-Verweis (Nothing in Visual Basic).
offset
ist kleiner als 0.
- oder -
offset
ist größer als die Länge von buffer
.
- oder -
count
ist kleiner als 0.
- oder -
offset
plus die Anzahl ist größer als die Länge von buffer
.
Die Multicastgruppe wurde noch nicht zusammengeführt.
UdpAnySourceMulticastClient wurde verworfen.
Fehler beim Versuch, auf den Socket zuzugreifen.
Hinweise
Die BeginReceiveFromGroup -Methode beginnt einen Vorgang zum Empfangen eines UDP-Pakets von der verknüpften Multicastgruppe von einem beliebigen Absender. Der lokale Port und die Multicastgruppenadresse werden im UdpAnySourceMulticastClient Konstruktor angegeben. Der Multicastclient muss auch eine Verknüpfung mit der Multicastgruppe abgeschlossen haben.
Die im callback
Parameter angegebene Methode wird aufgerufen, wenn ein Paket empfangen wurde.
Es ist möglich, einen Socketfehler zu haben, wenn ein Empfangsvorgang synchron fehlschlägt, obwohl dies bei UDP ungewöhnlich ist. Wenn ein Socketfehler auftritt, wird ein SocketException ausgelöst. Der empfangene Fehler wird als Member der SocketError Enumeration angegeben.