UdpSingleSourceMulticastClient.BeginReceiveFromSource 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 bestimmten Absender in der Gruppe angekommen ist.
public:
IAsyncResult ^ BeginReceiveFromSource(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 BeginReceiveFromSource (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.BeginReceiveFromSource : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginReceiveFromSource (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.
UdpSingleSourceMulticastClient wurde verworfen.
Fehler beim Versuch, auf den Socket zum Empfangen zuzugreifen.
Hinweise
Die BeginReceiveFromSource -Methode beginnt einen Vorgang zum Empfangen eines UDP-Pakets von der eingebundenen Multicastgruppe von einem einzelnen Absender. Der lokale Port, die Multicastgruppe und die Absenderquelladresse werden im UdpSingleSourceMulticastClient 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.