Partilhar via


UdpSingleSourceMulticastClient.BeginReceiveFromSource Método

Definição

Cuidado

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

Inicia a operação de recebimento de um pacote do grupo de multicast unido e invoca o retorno de chamada especificado quando um pacote enviado por um remetente especificado é recebido pelo grupo.

public:
 IAsyncResult ^ BeginReceiveFromSource(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 BeginReceiveFromSource (byte[] buffer, int offset, int count, 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.BeginReceiveFromSource : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginReceiveFromSource (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

buffer
Byte[]

O buffer para armazenar os dados recebidos.

offset
Int32

O deslocamento, em bytes, do início do buffer em que os dados devem ser armazenados.

count
Int32

O número máximo de bytes a ser recebido e armazenado no buffer.

callback
AsyncCallback

O método de retorno de chamada a ser invocado quando a operação for concluída.

state
Object

As informações opcionais de estado a serem passadas para o método callback para essa operação.

Retornos

Um IAsyncResult que faz referência a essa operação.

Atributos

Exceções

buffer é uma referência nula (Nada no Visual Basic).

offset é menor que 0

- ou -

offset é maior que o comprimento do buffer.

- ou -

count é menor que 0

- ou -

offset mais a contagem é maior que o comprimento do buffer.

O grupo de multicast ainda não foi unido.

Ocorreu um erro ao tentar acessar o soquete para recebimento.

Comentários

O BeginReceiveFromSource método inicia uma operação de recebimento de um pacote UDP do grupo multicast unido de um único remetente. A porta local, o grupo multicast e o endereço de origem do remetente são especificados no UdpSingleSourceMulticastClient construtor. O cliente multicast também deve ter concluído uma junção ao grupo multicast.

O método especificado no callback parâmetro é invocado quando um pacote é recebido.

É possível ter uma falha de soquete se uma operação de recebimento falhar de forma síncrona, embora isso seja incomum com o UDP. Se ocorrer uma falha de soquete, um SocketException será gerado. O erro recebido é especificado como um membro da SocketError enumeração .

Aplica-se a