UdpAnySourceMulticastClient.BeginSendTo 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 envio de um pacote de unicast para o 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[]
O buffer que contém os dados a serem enviados.
- offset
- Int32
O deslocamento, em bytes, do início do buffer para ler os dados a serem enviados.
- count
- Int32
O número de bytes a serem enviados do buffer.
- remoteEndPoint
- IPEndPoint
O ponto de extremidade remoto ao qual o pacote será enviado.
- 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 UdpAnySourceMulticastClient foi descartado.
Ocorreu um erro ao tentar acessar o soquete.
Comentários
O BeginSendTo método inicia uma operação de envio de um pacote UDP para o grupo multicast unido.
O cliente deve ter concluído uma junção ao grupo multicast. O endereço de destino especificado no remoteEndPoint parâmetro já deve ter enviado um pacote multicast para esse receptor. Alguns protocolos usam essas informações para transmitir o controle de fluxo, a qualidade das estatísticas de serviço ou as mensagens de recuperação.
O método especificado no callback parâmetro é invocado quando um pacote é recebido.
A transmissão só será permitida se o endereço especificado no remoteEndPoint parâmetro já tiver enviado um pacote multicast para esse receptor. Se o cliente não tiver acesso permitido, um SocketException será gerado com AccessDenied.
Se a porta de destino especificada no remoteEndPoint parâmetro for menor que 1.024, uma SocketException será gerada com AccessDenied.
É possível ter uma falha de soquete se uma operação de recebimento falhar de forma síncrona, embora isso seja incomum com UDP. Se ocorrer uma falha de soquete, um SocketException será gerado. O erro recebido é especificado como um membro da SocketError enumeração .
