PeerContact.InviteAsync Método

Definição

Namespace:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Inicia uma operação de convite assíncrona para que um ponto de extremidade ingresse em um aplicativo PeerCollaboration patrocinado pelo remetente do convite.

Sobrecargas

InviteAsync(Object)	Inicia uma operação de convite assíncrona para que um ponto de extremidade ingresse em um aplicativo PeerCollaboration patrocinado pelo remetente do convite. O convite é identificado usando o Object especificado.
InviteAsync(PeerEndPoint, Object)	Inicia uma operação de convite assíncrona para o ponto de extremidade de par especificado ingressar em um aplicativo PeerCollaboration patrocinado pelo remetente do convite. O convite é identificado usando o Object especificado.
InviteAsync(PeerApplication, String, Byte[], Object)	Inicia uma operação de convite assíncrona para os pontos de extremidade de par especificados ingressarem em um PeerApplication de colaboração especificado patrocinado pelo remetente do convite.
InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object)	Inicia uma operação de convite assíncrona para o peerEndPoint especificado ingressar em um PeerApplication de colaboração especificado patrocinado pelo remetente do convite.

Comentários

O chamador não precisa entrar na System.Net.PeerToPeer.Collaboration infraestrutura para que esse método seja concluído com êxito. Um PeerInvitationResponse do convidado não é o mesmo que o convidado que aceita o convite para colaborar. Se um convite for enviado para um par remoto que não instalou o aplicativo, o convite será recusado automaticamente.

InviteAsync(Object)

Inicia uma operação de convite assíncrona para que um ponto de extremidade ingresse em um aplicativo PeerCollaboration patrocinado pelo remetente do convite. O convite é identificado usando o Object especificado.

public:
 override void InviteAsync(System::Object ^ userToken);

[System.Security.SecurityCritical]
public override void InviteAsync (object userToken);

[<System.Security.SecurityCritical>]
override this.InviteAsync : obj -> unit

Public Overrides Sub InviteAsync (userToken As Object)

Parâmetros

userToken

Object

O objeto definido pelo usuário a ser passado para o retorno de chamada da operação assíncrona. Usado também para identificar a operação assíncrona para cancelamento. Este parâmetro deve ser especificado e é exclusivo em todas as operações de convite assíncronas em andamento.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentException

UserToken não pode ser null.

ObjectDisposedException

O objeto PeerEndPoint foi descartado.

PeerToPeerException

• O Id do aplicativo atual não existe ou está vazio.

• PeerEndPointCollection não pode ser null.

Comentários

O chamador não precisa entrar na System.Net.PeerToPeer.Collaboration infraestrutura para que esse método seja concluído com êxito. Um PeerInvitationResponse do convidado não é o mesmo que o convidado que aceita o convite para colaborar. Se um convite for enviado para um par remoto que não instalou o aplicativo, o convite será recusado automaticamente.

Notas aos Chamadores

Sobrecargas adicionais são definidas na Peer classe em vez das subclasses PeerContact e PeerNearMe.

Chamar esse método requer um PermissionState de Unrestricted. Esse estado é criado quando a sessão de colaboração de pares começa.

Confira também

• InviteAsyncCancel(Object)
• InviteCompleted
• OnInviteCompleted(InviteCompletedEventArgs)

InviteAsync(PeerEndPoint, Object)

Inicia uma operação de convite assíncrona para o ponto de extremidade de par especificado ingressar em um aplicativo PeerCollaboration patrocinado pelo remetente do convite. O convite é identificado usando o Object especificado.

public:
 void InviteAsync(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, System::Object ^ userToken);

[System.Security.SecurityCritical]
public void InviteAsync (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, object userToken);

[<System.Security.SecurityCritical>]
override this.InviteAsync : System.Net.PeerToPeer.Collaboration.PeerEndPoint * obj -> unit

Public Sub InviteAsync (peerEndPoint As PeerEndPoint, userToken As Object)

Parâmetros

peerEndPoint

PeerEndPoint

O ponto de extremidade ou o par remoto para o qual enviar o convite.

userToken

Object

O objeto definido pelo usuário a ser passado para o retorno de chamada da operação assíncrona. Usado também para identificar a operação assíncrona para cancelamento. Este parâmetro deve ser especificado e é exclusivo em todas as operações de convite assíncronas em andamento.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentException

• UserToken não pode ser null.

• O ponto de extremidade no peerEndPoint não pode ser null.

ArgumentNullException

O objeto peerEndPoint não pode ser null.

ObjectDisposedException

O objeto PeerEndPoint foi descartado.

PeerToPeerException

O Guid do aplicativo atual não existe ou está vazio.

Comentários

O chamador não precisa entrar na System.Net.PeerToPeer.Collaboration infraestrutura para que esse método seja concluído com êxito. Um PeerInvitationResponse do convidado não é o mesmo que o convidado que aceita o convite para colaborar. Se um convite for enviado para um par remoto que não instalou o aplicativo, o convite será recusado automaticamente.

Notas aos Chamadores

Sobrecargas adicionais são definidas na Peer classe em vez das subclasses PeerContact e PeerNearMe.

Chamar esse método requer um PermissionState de Unrestricted. Esse estado é criado quando a sessão de colaboração de pares começa.

Confira também

• Id
• InviteAsyncCancel(Object)
• OnInviteCompleted(InviteCompletedEventArgs)
• Subscribe()

InviteAsync(PeerApplication, String, Byte[], Object)

Inicia uma operação de convite assíncrona para os pontos de extremidade de par especificados ingressarem em um PeerApplication de colaboração especificado patrocinado pelo remetente do convite.

public:
 override void InviteAsync(System::Net::PeerToPeer::Collaboration::PeerApplication ^ applicationToInvite, System::String ^ message, cli::array <System::Byte> ^ invitationData, System::Object ^ userToken);

[System.Security.SecurityCritical]
public override void InviteAsync (System.Net.PeerToPeer.Collaboration.PeerApplication applicationToInvite, string message, byte[] invitationData, object userToken);

[<System.Security.SecurityCritical>]
override this.InviteAsync : System.Net.PeerToPeer.Collaboration.PeerApplication * string * byte[] * obj -> unit

Public Overrides Sub InviteAsync (applicationToInvite As PeerApplication, message As String, invitationData As Byte(), userToken As Object)

Parâmetros

applicationToInvite

PeerApplication

O aplicativo para o qual o convite é enviado.

message

String

Uma mensagem a ser enviada para o par remoto com o convite do aplicativo. A mensagem não pode ter mais de 255 caracteres Unicode.

invitationData

Byte[]

Um blob de dados definido pelo usuário a ser associado ao convite. O tamanho não pode ser maior que 16.384 bytes.

userToken

Object

O objeto definido pelo usuário a ser passado para o retorno de chamada da operação assíncrona. Usado também para identificar a operação assíncrona para cancelamento. Este parâmetro deve ser especificado e é exclusivo em todas as operações de convite assíncronas em andamento.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentException

UserToken não pode ser null.

ArgumentNullException

O objeto PeerApplication não pode ser null.

ObjectDisposedException

O objeto PeerEndPoint foi descartado.

PeerToPeerException

• O Guid do aplicativo atual não existe ou está vazio.

• A coleção de pontos de extremidade está vazia ou null.

Comentários

O chamador não precisa entrar na System.Net.PeerToPeer.Collaboration infraestrutura para que esse método seja concluído com êxito. Um PeerInvitationResponse do convidado não é o mesmo que o convidado que aceita o convite para colaborar. Se um convite for enviado para um par remoto que não instalou o aplicativo, o convite será recusado automaticamente.

Notas aos Chamadores

Sobrecargas adicionais são definidas na Peer classe em vez das subclasses PeerContact e PeerNearMe.

Chamar esse método requer um PermissionState de Unrestricted. Esse estado é criado quando a sessão de colaboração de pares começa.

Confira também

• InviteAsyncCancel(Object)
• OnInviteCompleted(InviteCompletedEventArgs)
• Subscribe()

InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object)

Inicia uma operação de convite assíncrona para o peerEndPoint especificado ingressar em um PeerApplication de colaboração especificado patrocinado pelo remetente do convite.

public:
 void InviteAsync(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, System::String ^ message, cli::array <System::Byte> ^ invitationData, System::Net::PeerToPeer::Collaboration::PeerApplication ^ applicationToInvite, System::Object ^ userToken);

[System.Security.SecurityCritical]
public void InviteAsync (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, string message, byte[] invitationData, System.Net.PeerToPeer.Collaboration.PeerApplication applicationToInvite, object userToken);

[<System.Security.SecurityCritical>]
override this.InviteAsync : System.Net.PeerToPeer.Collaboration.PeerEndPoint * string * byte[] * System.Net.PeerToPeer.Collaboration.PeerApplication * obj -> unit

Public Sub InviteAsync (peerEndPoint As PeerEndPoint, message As String, invitationData As Byte(), applicationToInvite As PeerApplication, userToken As Object)

Parâmetros

peerEndPoint

PeerEndPoint

O ponto de extremidade ou o par remoto para o qual enviar o convite.

message

String

Uma mensagem a ser enviada para o par remoto com o convite do aplicativo. A mensagem não pode ter mais de 255 caracteres Unicode.

invitationData

Byte[]

Um blob de dados definido pelo usuário a ser associado ao convite. O tamanho não pode ser maior que 16.384 bytes.

applicationToInvite

PeerApplication

O aplicativo para o qual o convite é enviado.

userToken

Object

O objeto definido pelo usuário a ser passado para o retorno de chamada da operação assíncrona. Usado também para identificar a operação assíncrona para cancelamento. Este parâmetro deve ser especificado e é exclusivo em todas as operações de convite assíncronas em andamento.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentException

• UserToken não pode ser nulo.

• O ponto de extremidade especificado por peerEndPoint não pode ser null.

ArgumentNullException

Os objetos PeerApplication e PeerEndPoint não podem ser null.

ObjectDisposedException

O objeto PeerEndPoint foi descartado.

PeerToPeerException

O Id do aplicativo atual não existe ou está vazio.

Comentários

O chamador não precisa entrar na System.Net.PeerToPeer.Collaboration infraestrutura para que esse método seja concluído com êxito. Um PeerInvitationResponse do convidado não é o mesmo que o convidado que aceita o convite para colaborar. Se um convite for enviado para um par remoto que não instalou o aplicativo, o convite será recusado automaticamente.

Notas aos Chamadores

Sobrecargas adicionais são definidas na Peer classe em vez das subclasses PeerContact e PeerNearMe.

Chamar esse método requer um PermissionState de Unrestricted. Esse estado é criado quando a sessão de colaboração de pares começa.

Confira também

• InviteAsyncCancel(Object)
• OnInviteCompleted(InviteCompletedEventArgs)
• Subscribe()