PeerContact.InviteAsync Méthode

Définition

Espace de noms:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Lance une opération d’invitation asynchrone pour un point de terminaison afin de joindre une application PeerCollaboration parrainée par l’expéditeur de l’invitation.

Surcharges

InviteAsync(Object)	Lance une opération d’invitation asynchrone pour un point de terminaison afin de joindre une application PeerCollaboration parrainée par l’expéditeur de l’invitation. L’invitation est identifiée à l’aide de l’objet Object spécifié.
InviteAsync(PeerEndPoint, Object)	Lance une opération d’invitation asynchrone pour le point de terminaison d’homologue spécifié pour joindre une application PeerCollaboration parrainée par l’expéditeur de l’invitation. L’invitation est identifiée à l’aide de l’objet Object spécifié.
InviteAsync(PeerApplication, String, Byte[], Object)	Lance une opération d’invitation asynchrone pour le point de terminaison d’homologue spécifié pour joindre la collaboration PeerApplication spécifiée, parrainée par l’expéditeur de l’invitation.
InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object)	Lance une opération d’invitation asynchrone pour le peerEndPoint spécifié pour joindre la collaboration PeerApplication spécifiée, parrainée par l’expéditeur de l’invitation.

Remarques

L’appelant n’est pas obligé de se connecter à l’infrastructure System.Net.PeerToPeer.Collaboration pour que cette méthode se termine correctement. Un PeerInvitationResponse de l’invité n’est pas identique à celui qui accepte l’invitation à collaborer. Si une invitation est envoyée à un homologue distant qui n’a pas installé l’application, l’invitation est automatiquement refusée.

InviteAsync(Object)

Lance une opération d’invitation asynchrone pour un point de terminaison afin de joindre une application PeerCollaboration parrainée par l’expéditeur de l’invitation. L’invitation est identifiée à l’aide de l’objet Object spécifié.

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)

Paramètres

userToken

Object

Objet défini par l’utilisateur à transmettre au rappel de l’opération asynchrone. Également utilisé afin d’identifier l’opération asynchrone pour l’annulation. Ce paramètre doit être spécifié et être unique pour toutes les opérations d’invitation asynchrones en cours.

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentException

UserToken ne peut pas avoir la valeur null.

ObjectDisposedException

L’objet PeerEndPoint a été supprimé.

PeerToPeerException

• Le Id de l’application actuelle n’existe pas ou est vide.

• PeerEndPointCollection ne peut pas avoir la valeur null.

Remarques

L’appelant n’est pas obligé de se connecter à l’infrastructure System.Net.PeerToPeer.Collaboration pour que cette méthode se termine correctement. Un PeerInvitationResponse de l’invité n’est pas identique à celui qui accepte l’invitation à collaborer. Si une invitation est envoyée à un homologue distant qui n’a pas installé l’application, l’invitation est automatiquement refusée.

Notes pour les appelants

Des surcharges supplémentaires sont définies sur la Peer classe au lieu des sous-classes PeerContact et PeerNearMe.

L’appel de cette méthode nécessite un PermissionState de Unrestricted. Cet état est créé lorsque la session de collaboration d’homologue commence.

Voir aussi

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

InviteAsync(PeerEndPoint, Object)

Lance une opération d’invitation asynchrone pour le point de terminaison d’homologue spécifié pour joindre une application PeerCollaboration parrainée par l’expéditeur de l’invitation. L’invitation est identifiée à l’aide de l’objet Object spécifié.

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)

Paramètres

peerEndPoint

PeerEndPoint

Le point de terminaison ou l’homologue distant auquel l’invitation doit être envoyée.

userToken

Object

Objet défini par l’utilisateur à transmettre au rappel de l’opération asynchrone. Également utilisé afin d’identifier l’opération asynchrone pour l’annulation. Ce paramètre doit être spécifié et être unique pour toutes les opérations d’invitation asynchrones en cours.

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentException

• UserToken ne peut pas avoir la valeur null.

• Le point de terminaison dans peerEndPoint ne peut pas être null.

ArgumentNullException

L’objet peerEndPoint ne peut pas être null.

ObjectDisposedException

L’objet PeerEndPoint a été supprimé.

PeerToPeerException

Le Guid de l’application actuelle n’existe pas ou est vide.

Remarques

L’appelant n’est pas obligé de se connecter à l’infrastructure System.Net.PeerToPeer.Collaboration pour que cette méthode se termine correctement. Un PeerInvitationResponse de l’invité n’est pas identique à celui qui accepte l’invitation à collaborer. Si une invitation est envoyée à un homologue distant qui n’a pas installé l’application, l’invitation est automatiquement refusée.

Notes pour les appelants

Des surcharges supplémentaires sont définies sur la Peer classe au lieu des sous-classes PeerContact et PeerNearMe.

L’appel de cette méthode nécessite un PermissionState de Unrestricted. Cet état est créé lorsque la session de collaboration d’homologue commence.

Voir aussi

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

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

Lance une opération d’invitation asynchrone pour le point de terminaison d’homologue spécifié pour joindre la collaboration PeerApplication spécifiée, parrainée par l’expéditeur de l’invitation.

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)

Paramètres

applicationToInvite

PeerApplication

L’application pour laquelle l’invitation est envoyée.

message

String

Un message à envoyer à l’homologue distant avec l’invitation à l’application. Le message ne peut pas dépasser 255 caractères Unicode.

invitationData

Byte[]

Objet blob de données défini par l’utilisateur à associer à l’invitation. Sa taille ne doit pas dépasser 16 384 octets.

userToken

Object

Objet défini par l’utilisateur à transmettre au rappel de l’opération asynchrone. Également utilisé afin d’identifier l’opération asynchrone pour l’annulation. Ce paramètre doit être spécifié et être unique pour toutes les opérations d’invitation asynchrones en cours.

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentException

UserToken ne peut pas avoir la valeur null.

ArgumentNullException

L’objet PeerApplication ne peut pas être null.

ObjectDisposedException

L’objet PeerEndPoint a été supprimé.

PeerToPeerException

• Le Guid de l’application actuelle n’existe pas ou est vide.

• La collection de points de terminaison est vide ou null.

Remarques

L’appelant n’est pas obligé de se connecter à l’infrastructure System.Net.PeerToPeer.Collaboration pour que cette méthode se termine correctement. Un PeerInvitationResponse de l’invité n’est pas identique à celui qui accepte l’invitation à collaborer. Si une invitation est envoyée à un homologue distant qui n’a pas installé l’application, l’invitation est automatiquement refusée.

Notes pour les appelants

Des surcharges supplémentaires sont définies sur la Peer classe au lieu des sous-classes PeerContact et PeerNearMe.

L’appel de cette méthode nécessite un PermissionState de Unrestricted. Cet état est créé lorsque la session de collaboration d’homologue commence.

Voir aussi

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

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

Lance une opération d’invitation asynchrone pour le peerEndPoint spécifié pour joindre la collaboration PeerApplication spécifiée, parrainée par l’expéditeur de l’invitation.

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)

Paramètres

peerEndPoint

PeerEndPoint

Le point de terminaison ou l’homologue distant auquel l’invitation doit être envoyée.

message

String

Un message à envoyer à l’homologue distant avec l’invitation à l’application. Le message ne peut pas dépasser 255 caractères Unicode.

invitationData

Byte[]

Objet blob de données défini par l’utilisateur à associer à l’invitation. Sa taille ne doit pas dépasser 16 384 octets.

applicationToInvite

PeerApplication

L’application pour laquelle l’invitation est envoyée.

userToken

Object

Objet défini par l’utilisateur à transmettre au rappel de l’opération asynchrone. Également utilisé afin d’identifier l’opération asynchrone pour l’annulation. Ce paramètre doit être spécifié et être unique pour toutes les opérations d’invitation asynchrones en cours.

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentException

• UserToken ne peut pas être null.

• Le point de terminaison spécifié par peerEndPoint ne peut pas être null.

ArgumentNullException

PeerApplication et PeerEndPoint ne peuvent pas être null.

ObjectDisposedException

L’objet PeerEndPoint a été supprimé.

PeerToPeerException

Le Id de l’application actuelle n’existe pas ou est vide.

Remarques

L’appelant n’est pas obligé de se connecter à l’infrastructure System.Net.PeerToPeer.Collaboration pour que cette méthode se termine correctement. Un PeerInvitationResponse de l’invité n’est pas identique à celui qui accepte l’invitation à collaborer. Si une invitation est envoyée à un homologue distant qui n’a pas installé l’application, l’invitation est automatiquement refusée.

Notes pour les appelants

Des surcharges supplémentaires sont définies sur la Peer classe au lieu des sous-classes PeerContact et PeerNearMe.

L’appel de cette méthode nécessite un PermissionState de Unrestricted. Cet état est créé lorsque la session de collaboration d’homologue commence.

Voir aussi

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