UdpAnySourceMulticastClient.BeginSendTo Méthode

Définition

Attention

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

Commence l’opération d’envoi d’un paquet de monodiffusion à la destination spécifiée.

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

Paramètres

buffer
Byte[]

Mémoire tampon qui contient les données à envoyer.

offset
Int32

Décalage, en octets, en partant du début de buffer pour lire les données à envoyer.

count
Int32

Nombre d’octets à envoyer à partir de buffer.

remoteEndPoint
IPEndPoint

Point de terminaison distant auquel le paquet doit être envoyé.

callback
AsyncCallback

Méthode de rappel à appeler quand l’opération se termine.

state
Object

Informations d’état facultatives à passer à la méthode callback pour cette opération.

Retours

IAsyncResult qui fait référence à cette opération.

Attributs

Exceptions

buffer est une référence Null (Nothing en Visual Basic).

offset est inférieur à 0.

- ou -

offset est supérieur à la longueur de buffer.

- ou -

count est inférieur à 0.

- ou -

offset plus count est supérieur à la longueur de buffer.

Le groupe de multidiffusion n’a pas encore été joint.

Une erreur s’est produite pendant la tentative d’accès au socket.

Remarques

La BeginSendTo méthode commence une opération d’envoi d’un paquet UDP au groupe de multidiffusion joint.

Le client doit avoir terminé une jointure au groupe de multidiffusion. L’adresse de destination spécifiée dans le remoteEndPoint paramètre doit avoir déjà envoyé un paquet de multidiffusion à ce récepteur. Certains protocoles utilisent ces informations pour transmettre le contrôle de flux, les statistiques de qualité du service ou les messages de récupération.

La méthode spécifiée dans le callback paramètre est appelée lorsqu’un paquet a reçu.

La transmission n’est autorisée que si l’adresse spécifiée dans le remoteEndPoint paramètre a déjà envoyé un paquet de multidiffusion à ce récepteur. Si le client n’est pas autorisé à accéder, un SocketException est levée avec AccessDenied.

Si le port de destination spécifié dans le remoteEndPoint paramètre est inférieur à 1 024, un SocketException est levée avec AccessDenied.

Il est possible d’avoir un échec de socket si une opération de réception échoue de manière synchrone, bien que cela soit rare avec UDP. Si un échec de socket se produit, un SocketException est levée. L’erreur reçue est spécifiée en tant que membre de l’énumération SocketError .

S’applique à