UdpSingleSourceMulticastClient.BeginReceiveFromSource Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> IAsyncResultPublic Function BeginReceiveFromSource (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParâ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.
O UdpSingleSourceMulticastClient foi descartado.
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 .
