UdpAnySourceMulticastClient.BeginSendTo Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> IAsyncResultPublic Function BeginSendTo (buffer As Byte(), offset As Integer, count As Integer, remoteEndPoint As IPEndPoint, callback As AsyncCallback, state As Object) As IAsyncResultPará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.
Se ha eliminado UdpAnySourceMulticastClient.
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, las estadísticas de calidad del 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 parámetro ya remoteEndPoint ha enviado un paquete de multidifusión a este receptor. Si no se permite el acceso al cliente, SocketException se produce un con AccessDenied .
Si el puerto de destino especificado en el parámetro es remoteEndPoint menor que 1024, se SocketException produce con AccessDenied .
Es posible tener un error de socket si se produce un error sincrónico en una operación de recepción, aunque esto no es habitual con UDP. Si se produce un error de socket, SocketException se produce una excepción . El error recibido se especifica como miembro de la SocketError enumeración .