UdpAnySourceMulticastClient.BeginJoinGroup(AsyncCallback, Object) Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.dll

Cuidado

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

Associa o soquete e começa uma operação de união ao grupo de multicast para permitir que os datagramas sejam recebidos de qualquer participante do grupo.

public:
 IAsyncResult ^ BeginJoinGroup(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 BeginJoinGroup (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.BeginJoinGroup : AsyncCallback * obj -> IAsyncResult

Public Function BeginJoinGroup (callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

callback

AsyncCallback

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

state

Object

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

Retornos

IAsyncResult

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

Atributos

ObsoleteAttribute

Exceções

InvalidOperationException

O grupo de multicast já foi unido ou uma operação de união está em andamento.

ObjectDisposedException

O UdpAnySourceMulticastClient foi descartado.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

Comentários

O BeginJoinGroup método associa um soquete multicast UDP a uma porta local e une um grupo multicast para permitir que datagramas sejam recebidos de qualquer participante do grupo multicast. A porta local e o endereço do grupo multicast são especificados no UdpAnySourceMulticastClient construtor.

O método especificado no callback parâmetro é invocado quando a operação para unir o grupo multicast é concluída.

Se exigido pelo runtime, o BeginJoinGroup método também executa uma política marcar para verificar se o cliente tem permissão para acessar o grupo multicast. Se o cliente não tiver permissão de acesso, um SocketException será gerado com AccessDenied.