Compartir vía


UdpAnySourceMulticastClient.BeginSendTo Método

Definición

Precaución

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

Comienza la operación de envío de un paquete de unidifusión al destino especificado.

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

Parámetros

buffer
Byte[]

Búfer que contiene los datos que se van a enviar.

offset
Int32

Desplazamiento, en bytes, desde el principio del parámetro buffer para leer los datos que se van a enviar.

count
Int32

Número de bytes que se van a enviar desde el parámetro buffer.

remoteEndPoint
IPEndPoint

Punto de conexión remoto al que se va a enviar el paquete.

callback
AsyncCallback

Método de devolución de llamada que se invocará cuando se complete la operación.

state
Object

Información de estado opcional para pasar al método callback de esta operación.

Devoluciones

Elemento IAsyncResult que hace referencia a esta operación.

Atributos

Excepciones

buffer es una referencia nula (nada en Visual Basic).

offset es menor que 0

o bien

offset es mayor que la longitud del parámetro buffer.

o bien

count es menor que 0

o bien

offset más el recuento es mayor que la longitud del parámetro buffer.

El grupo de multidifusión no se unió todavía.

Error al intentar acceder al socket.

Comentarios

El BeginSendTo método comienza una operación de envío de un paquete UDP al grupo de multidifusión unido.

El cliente debe haber completado una unión al grupo de multidifusión. La dirección de destino especificada en el remoteEndPoint parámetro debe haber enviado ya un paquete de multidifusión a este receptor. Algunos protocolos usan esta información para pasar el control de flujo, la calidad de las estadísticas de servicio o los mensajes de recuperación.

El método especificado en el callback parámetro se invoca cuando se ha recibido un paquete.

La transmisión solo se permite si la dirección especificada en el remoteEndPoint parámetro ya ha enviado un paquete de multidifusión a este receptor. Si no se permite el acceso al cliente, se produce una SocketException excepción con AccessDenied.

Si el puerto de destino especificado en el remoteEndPoint parámetro es menor que 1024, se produce una SocketException excepción con AccessDenied.

Es posible tener un error de socket si se produce un error en una operación de recepción de forma sincrónica, aunque esto es poco común con UDP. Si se produce un error de socket, se produce una SocketException excepción . El error recibido se especifica como miembro de la SocketError enumeración.

Se aplica a