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

Definición

Advertencia

Esta API está ya obsoleta.

Inicia la operación de recepción de un paquete del grupo de multidifusión unido e invoca la devolución de llamada especificada cuando un paquete llegó al grupo procedente de cualquier remitente.Begins the operation of receiving a packet from the joined multicast group and invokes the specified callback when a packet has arrived on the group from any sender.

public:
 IAsyncResult ^ BeginReceiveFromGroup(cli::array <System::Byte> ^ buffer, int offset, int count, 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 BeginReceiveFromGroup (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
member this.BeginReceiveFromGroup : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginReceiveFromGroup (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

buffer
Byte[]

Búfer para almacenar los datos recibidos.The buffer to store the received data.

offset
Int32 Int32 Int32 Int32

Desplazamiento, en bytes, desde el principio del buffer donde deberían almacenarse los datos.The offset, in bytes, from the beginning of the buffer where the data should be stored.

count
Int32 Int32 Int32 Int32

Número máximo de bytes que se van a recibir y a almacenar en el buffer.The maximum number of bytes to receive and store in the buffer.

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 BeginReceiveFromGroup método inicia una operación de recepción de un paquete UDP desde el grupo de multidifusión Unido de cualquier remitente.The BeginReceiveFromGroup method begins an operation of receiving a UDP packet from the joined multicast group from any sender. El puerto local y la dirección del grupo de multidifusión UdpAnySourceMulticastClient se especifican en el constructor.The local port and multicast group address are specified in the UdpAnySourceMulticastClient constructor. El cliente de multidifusión también debe haber completado una combinación con el grupo de multidifusión.The multicast client must also have completed a join to the multicast group.

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

Es posible que se produzca un error de socket si se produce un error en una operación de recepción de forma sincrónica, aunque esto no 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 SocketException , se produce una excepción.If a socket failure occurs, a SocketException is thrown. El error recibido se especifica como un miembro de la SocketError enumeración.The error received is specified as a member of the SocketError enumeration.

Se aplica a