UdpAnySourceMulticastClient.BeginSendTo Methode

Definition

Achtung

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

Beginnt mit dem Senden eines Unicastpakets an das angegebene Ziel.

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 Byte) vom Anfang des buffer zu sendenden Datenlesevorgangs.

count
Int32

Die Anzahl der Bytes, die von der buffer.

remoteEndPoint
IPEndPoint

Der Remoteendpunkt, an den das Paket gesendet werden soll.

callback
AsyncCallback

Die Rückrufmethode, die aufgerufen werden soll, wenn der Vorgang abgeschlossen ist.

state
Object

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

Gibt zurück

Ein IAsyncResult Verweis auf diesen Vorgang.

Attribute

Ausnahmen

buffer ist ein Nullverweis (Nichts in Visual Basic).

offset ist kleiner als 0

-oder-

offset ist größer als die Länge der buffer.

-oder-

count ist kleiner als 0

-oder-

offset plus die Anzahl ist größer als die Länge der buffer.

Der Multicast-Gruppe wurde noch nicht beigetreten.

Beim Versuch, auf den Socket zuzugreifen, ist ein Fehler aufgetreten.

Hinweise

Die BeginSendTo Methode beginnt einen Vorgang zum Senden eines UDP-Pakets an die verbundene Multicastgruppe.

Der Client muss eine Verknüpfung zur 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 Ablaufsteuerung, 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 der Client keinen Zugriff gewährt, wird ein SocketException Fehler ausgelöst mit AccessDenied.

Wenn der im remoteEndPoint Parameter angegebene Zielport kleiner als 1.024 ist, wird ein SocketException Fehler ausgelöst.AccessDenied

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 Fehler ausgelöst. Der empfangene Fehler wird als Element der SocketError Enumeration angegeben.

Gilt für: