PeerContact.InviteAsync Methode

Definition

Namespace:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Startet einen asynchronen Einladungsvorgang für einen angegebenen Endpunkt, um einer PeerCollaboration-Anwendung beizutreten, die vom Absender der Einladung gesponsert wird.

Überlädt

InviteAsync(Object)	Startet einen asynchronen Einladungsvorgang für einen angegebenen Endpunkt, um einer PeerCollaboration-Anwendung beizutreten, die vom Absender der Einladung gesponsert wird. Die Einladung wird mit dem angegebenen Object identifiziert.
InviteAsync(PeerEndPoint, Object)	Startet einen asynchronen Einladungsvorgang für den angegebenen Peerendpunkt, um einer PeerCollaboration-Anwendung beizutreten, die vom Absender der Einladung gesponsert wird. Die Einladung wird mit dem angegebenen Object identifiziert.
InviteAsync(PeerApplication, String, Byte[], Object)	Startet einen asynchronen Einladungsvorgang für die angegebenen Peerendpunkte, um der angegebenen PeerApplication für die Zusammenarbeit beizutreten, die vom Absender der Einladung gesponsert wird.
InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object)	Startet einen asynchronen Einladungsvorgang für den angegebenen peerEndPoint, um der angegebenen PeerApplication für die Zusammenarbeit beizutreten, die vom Absender der Einladung gesponsert wird.

Hinweise

Der Aufrufer muss sich nicht bei der System.Net.PeerToPeer.Collaboration Infrastruktur anmelden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein PeerInvitationResponse vom Eingeladenen ist nicht dasselbe wie der Eingeladene, der die Einladung zur Zusammenarbeit annimmt. Wenn eine Einladung an einen Remotepeer gesendet wird, der die Anwendung nicht installiert hat, wird die Einladung automatisch abgelehnt.

InviteAsync(Object)

Startet einen asynchronen Einladungsvorgang für einen angegebenen Endpunkt, um einer PeerCollaboration-Anwendung beizutreten, die vom Absender der Einladung gesponsert wird. Die Einladung wird mit dem angegebenen Object identifiziert.

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)

Parameter

userToken

Object

Benutzerdefiniertes Objekt, das an den Rückruf des asynchronen Vorgangs übergeben werden soll. Wird auch zum Identifizieren des asynchronen Vorgangs für den Abbruch verwendet. Dieser Parameter muss angegeben werden und ist für alle asynchronen Einladungsvorgänge eindeutig.

Attribute

SecurityCriticalAttribute

Ausnahmen

ArgumentException

UserToken darf nicht null sein.

ObjectDisposedException

Das PeerEndPoint -Objekt wurde verworfen.

PeerToPeerException

• Die Id für die aktuelle Anwendung ist nicht vorhanden oder leer.

• PeerEndPointCollection darf nicht null sein.

Hinweise

Der Aufrufer muss sich nicht bei der System.Net.PeerToPeer.Collaboration Infrastruktur anmelden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein PeerInvitationResponse vom Eingeladenen ist nicht dasselbe wie der Eingeladene, der die Einladung zur Zusammenarbeit annimmt. Wenn eine Einladung an einen Remotepeer gesendet wird, der die Anwendung nicht installiert hat, wird die Einladung automatisch abgelehnt.

Hinweise für Aufrufer

Zusätzliche Überladungen werden für die Peer -Klasse anstelle der Unterklassen PeerContact und PeerNearMedefiniert.

Für das Aufrufen dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Peerzusammenarbeitssitzung beginnt.

Weitere Informationen

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

InviteAsync(PeerEndPoint, Object)

Startet einen asynchronen Einladungsvorgang für den angegebenen Peerendpunkt, um einer PeerCollaboration-Anwendung beizutreten, die vom Absender der Einladung gesponsert wird. Die Einladung wird mit dem angegebenen Object identifiziert.

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)

Parameter

peerEndPoint

PeerEndPoint

Der Endpunkt oder Remotepeer, an den die Einladung gesendet werden soll.

userToken

Object

Benutzerdefiniertes Objekt, das an den Rückruf des asynchronen Vorgangs übergeben werden soll. Wird auch zum Identifizieren des asynchronen Vorgangs für den Abbruch verwendet. Dieser Parameter muss angegeben werden und ist für alle asynchronen Einladungsvorgänge eindeutig.

Attribute

SecurityCriticalAttribute

Ausnahmen

ArgumentException

• UserToken darf nicht null sein.

• Der Endpunkt in peerEndPoint darf nicht null sein.

ArgumentNullException

Das peerEndPoint-Objekt darf nicht null sein.

ObjectDisposedException

Das PeerEndPoint -Objekt wurde verworfen.

PeerToPeerException

Die Guid für die aktuelle Anwendung ist nicht vorhanden oder leer.

Hinweise

Der Aufrufer muss sich nicht bei der System.Net.PeerToPeer.Collaboration Infrastruktur anmelden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein PeerInvitationResponse vom Eingeladenen ist nicht dasselbe wie der Eingeladene, der die Einladung zur Zusammenarbeit annimmt. Wenn eine Einladung an einen Remotepeer gesendet wird, der die Anwendung nicht installiert hat, wird die Einladung automatisch abgelehnt.

Hinweise für Aufrufer

Zusätzliche Überladungen werden für die Peer -Klasse anstelle der Unterklassen PeerContact und PeerNearMedefiniert.

Für das Aufrufen dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Peerzusammenarbeitssitzung beginnt.

Weitere Informationen

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

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

Startet einen asynchronen Einladungsvorgang für die angegebenen Peerendpunkte, um der angegebenen PeerApplication für die Zusammenarbeit beizutreten, die vom Absender der Einladung gesponsert wird.

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)

Parameter

applicationToInvite

PeerApplication

Die Anwendung, für die die Einladung gesendet wird.

message

String

Eine Nachricht, die zusammen mit der Anwendungseinladung an den Remotepeer gesendet werden soll. Die Nachricht darf 255 Unicode-Zeichen nicht überschreiten.

invitationData

Byte[]

Ein benutzerdefiniertes Datenblob, das der Einladung zugeordnet werden soll. Die Größe darf 16.384 Bytes nicht übersteigen.

userToken

Object

Benutzerdefiniertes Objekt, das an den Rückruf des asynchronen Vorgangs übergeben werden soll. Wird auch zum Identifizieren des asynchronen Vorgangs für den Abbruch verwendet. Dieser Parameter muss angegeben werden und ist für alle asynchronen Einladungsvorgänge eindeutig.

Attribute

SecurityCriticalAttribute

Ausnahmen

ArgumentException

UserToken darf nicht null sein.

ArgumentNullException

Das PeerApplication-Objekt darf nicht null sein.

ObjectDisposedException

Das PeerEndPoint -Objekt wurde verworfen.

PeerToPeerException

• Die Guid für die aktuelle Anwendung ist nicht vorhanden oder leer.

• Die Endpunktsammlung ist leer oder null.

Hinweise

Der Aufrufer muss sich nicht bei der System.Net.PeerToPeer.Collaboration Infrastruktur anmelden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein PeerInvitationResponse vom Eingeladenen ist nicht dasselbe wie der Eingeladene, der die Einladung zur Zusammenarbeit annimmt. Wenn eine Einladung an einen Remotepeer gesendet wird, der die Anwendung nicht installiert hat, wird die Einladung automatisch abgelehnt.

Hinweise für Aufrufer

Zusätzliche Überladungen werden für die Peer -Klasse anstelle der Unterklassen PeerContact und PeerNearMedefiniert.

Für das Aufrufen dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Peerzusammenarbeitssitzung beginnt.

Weitere Informationen

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

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

Startet einen asynchronen Einladungsvorgang für den angegebenen peerEndPoint, um der angegebenen PeerApplication für die Zusammenarbeit beizutreten, die vom Absender der Einladung gesponsert wird.

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)

Parameter

peerEndPoint

PeerEndPoint

Der Endpunkt oder Remotepeer, an den die Einladung gesendet werden soll.

message

String

Eine Nachricht, die zusammen mit der Anwendungseinladung an den Remotepeer gesendet werden soll. Die Nachricht darf 255 Unicode-Zeichen nicht überschreiten.

invitationData

Byte[]

Ein benutzerdefiniertes Datenblob, das der Einladung zugeordnet werden soll. Die Größe darf 16.384 Bytes nicht übersteigen.

applicationToInvite

PeerApplication

Die Anwendung, für die die Einladung gesendet wird.

userToken

Object

Benutzerdefiniertes Objekt, das an den Rückruf des asynchronen Vorgangs übergeben werden soll. Wird auch zum Identifizieren des asynchronen Vorgangs für den Abbruch verwendet. Dieser Parameter muss angegeben werden und ist für alle asynchronen Einladungsvorgänge eindeutig.

Attribute

SecurityCriticalAttribute

Ausnahmen

ArgumentException

• UserToken darf nicht NULL sein.

• Der durch peerEndPoint angegebene Endpunkt kann nicht null sein.

ArgumentNullException

PeerApplication - und PeerEndPoint -Objekte können nicht nullerforderlich sind.

ObjectDisposedException

Das PeerEndPoint -Objekt wurde verworfen.

PeerToPeerException

Die Id für die aktuelle Anwendung ist nicht vorhanden oder leer.

Hinweise

Der Aufrufer muss sich nicht bei der System.Net.PeerToPeer.Collaboration Infrastruktur anmelden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein PeerInvitationResponse vom Eingeladenen ist nicht dasselbe wie der Eingeladene, der die Einladung zur Zusammenarbeit annimmt. Wenn eine Einladung an einen Remotepeer gesendet wird, der die Anwendung nicht installiert hat, wird die Einladung automatisch abgelehnt.

Hinweise für Aufrufer

Zusätzliche Überladungen werden für die Peer -Klasse anstelle der Unterklassen PeerContact und PeerNearMedefiniert.

Für das Aufrufen dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Peerzusammenarbeitssitzung beginnt.

Weitere Informationen

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