UdpAnySourceMulticastClient.BeginSendTo(Byte[], Int32, Int32, IPEndPoint, AsyncCallback, Object) UdpAnySourceMulticastClient.BeginSendTo(Byte[], Int32, Int32, IPEndPoint, AsyncCallback, Object) UdpAnySourceMulticastClient.BeginSendTo(Byte[], Int32, Int32, IPEndPoint, AsyncCallback, Object) UdpAnySourceMulticastClient.BeginSendTo(Byte[], Int32, Int32, IPEndPoint, AsyncCallback, Object) Method

Definición

Advertencia

Esta API está ya obsoleta.

Comienza la operación de envío de un paquete de unidifusión al destino especificado.Begins the operation of sending a unicast packet to the specified destination.

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);
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.The buffer that contains the data to send.

offset
Int32 Int32 Int32 Int32

Desplazamiento, en bytes, desde el principio del parámetro buffer para leer los datos que se van a enviar.The offset, in bytes, from the beginning of the buffer to read the data to be sent.

count
Int32 Int32 Int32 Int32

Número de bytes que se van a enviar desde el parámetro buffer.The number of bytes to send from the buffer.

remoteEndPoint
IPEndPoint IPEndPoint IPEndPoint IPEndPoint

Punto de conexión remoto al que se va a enviar el paquete.The remote endpoint to which the packet is to be sent.

callback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

Método de devolución de llamada que se invocará cuando se complete la operación.The callback method to invoke when the operation completes.

state
Object Object Object Object

Información de estado opcional para pasar al método callback de esta operación.Optional state information to pass to the callback method for this operation.

Devoluciones

Elemento IAsyncResult que hace referencia a esta operación.An IAsyncResult that references this operation.

Excepciones

buffer es una referencia nula (nada en Visual Basic).buffer is a null reference (Nothing in Visual Basic).

offset es menor que 0offset is less than 0 O bien-or- offset es mayor que la longitud del parámetro buffer.offset is greater than the length of the buffer.

O bien-or- count es menor que 0count is less than 0 O bien-or- offset más el recuento es mayor que la longitud del parámetro buffer.offset plus the count is greater than the length of the buffer.

El grupo de multidifusión no se unió todavía.The multicast group has not yet been joined.

Error al intentar acceder al socket.An error occurred when attempting to access the socket.

Comentarios

El BeginSendTo método comienza una operación de envío de un paquete UDP para el grupo de multidifusión.The BeginSendTo method begins an operation of sending a UDP packet to the joined multicast group.

El cliente debe haber completado una combinación para el grupo de multidifusión.The client must have completed a join to the multicast group. La dirección de destino especificada en el remoteEndPoint parámetro debe ya has enviado un paquete de multidifusión a este receptor.The destination address specified in the remoteEndPoint parameter must have already sent a multicast packet to this receiver. Algunos protocolos de utilizan esta información para pasar a lo largo de control de flujo de calidad de las estadísticas del servicio o mensajes de recuperación.Some protocols use this information to pass along flow control, quality of service statistics, or recovery messages.

El método especificado en el callback parámetro se invoca cuando ha recibido un paquete.The method specified in the callback parameter is invoked when a packet has received.

Solo se permite la transmisión si la dirección especificada en el remoteEndPoint parámetro ya envió un paquete de multidifusión a este receptor.The transmission is only allowed if the address specified in the remoteEndPoint parameter has already sent a multicast packet to this receiver. Si el cliente no puede tener acceso, un SocketException se produce con AccessDenied.If the client is not allowed access, a SocketException is thrown with AccessDenied.

Si el puerto de destino especificado en el remoteEndPoint parámetro es inferior a 1.024, un SocketException se produce con AccessDenied.If the destination port specified in the remoteEndPoint parameter is less than 1,024, a SocketException is thrown with AccessDenied.

Es posible que haya un error de socket si una operación de recepción se produce un error de forma sincrónica, aunque es habitual con UDP.It is possible to have a socket failure if a receive operation fails synchronously, although this is uncommon with UDP. Si se produce un error de socket, un SocketException se produce.If a socket failure occurs, a SocketException is thrown. El error recibido está especificado como un miembro de la SocketError enumeración.The error received is specified as a member of the SocketError enumeration.

Se aplica a