UdpAnySourceMulticastClient.BeginSendTo 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 den Vorgang, bei dem ein Unicastpaket an das angegebene Ziel gesendet wird.
public:
IAsyncResult ^ BeginSendTo(cli::array <System::Byte> ^ buffer, int offset, int count, System::Net::IPEndPoint ^ remoteEndPoint, 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 BeginSendTo (byte[] buffer, int offset, int count, System.Net.IPEndPoint remoteEndPoint, 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.BeginSendTo : byte[] * int * int * System.Net.IPEndPoint * AsyncCallback * obj -> IAsyncResult
Public Function BeginSendTo (buffer As Byte(), offset As Integer, count As Integer, remoteEndPoint As IPEndPoint, callback As AsyncCallback, state As Object) As IAsyncResult
Parameter
- buffer
- Byte[]
Der Puffer, der die zu sendenden Daten enthält.
- offset
- Int32
Der Offset in Bytes ab dem Anfang vom buffer
, aus dem die zu sendenden Daten gelesen werden sollen.
- count
- Int32
Die Anzahl von Bytes, die aus dem buffer
gesendet werden sollen.
- remoteEndPoint
- IPEndPoint
Der Remoteendpunkt, an den das Paket gesendet werden soll.
- 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 BeginSendTo -Methode beginnt einen Vorgang zum Senden eines UDP-Pakets an die eingebundene Multicastgruppe.
Der Client muss eine Verknüpfung mit der Multicastgruppe abgeschlossen haben. Die im remoteEndPoint
Parameter angegebene Zieladresse muss bereits ein Multicastpaket an diesen Empfänger gesendet haben. Einige Protokolle verwenden diese Informationen, um Flusssteuerung, Dienstqualitätsstatistiken oder Wiederherstellungsmeldungen zu übergeben.
Die im callback
-Parameter angegebene Methode wird aufgerufen, wenn ein Paket empfangen wurde.
Die Übertragung ist nur zulässig, wenn die im remoteEndPoint
Parameter angegebene Adresse bereits ein Multicastpaket an diesen Empfänger gesendet hat. Wenn dem Client der Zugriff nicht gestattet ist, wird ein SocketException mit AccessDeniedausgelöst.
Wenn der im remoteEndPoint
Parameter angegebene Zielport kleiner als 1.024 ist, wird ein SocketException mit AccessDeniedausgelöst.
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.