UdpSingleSourceMulticastClient.BeginSendToSource 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 a origem especificada anteriormente.
public:
IAsyncResult ^ BeginSendToSource(cli::array <System::Byte> ^ buffer, int offset, int count, int remotePort, 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 BeginSendToSource (byte[] buffer, int offset, int count, int remotePort, 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.BeginSendToSource : byte[] * int * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginSendToSource (buffer As Byte(), offset As Integer, count As Integer, remotePort As Integer, callback As AsyncCallback, state As Object) As IAsyncResult
Parâ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
.
- remotePort
- Int32
A porta remota para a qual o pacote será enviado. O endereço remoto é especificado pelo construtor UdpSingleSourceMulticastClient(IPAddress, IPAddress, Int32).
- 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
.
- ou -
remotePort
é menor que 0 ou maior que 65.535.
O grupo de multicast ainda não foi unido.
O UdpSingleSourceMulticastClient foi descartado.
Ocorreu um erro ao tentar acessar o soquete.
Comentários
O BeginSendToSource método inicia uma operação de envio de um pacote UDP para a origem especificada anteriormente.
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 é enviado.
O cliente deve ter concluído uma junção ao grupo multicast.
Se a porta de destino especificada no remotePort
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 envio 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 .