PeerContact::InviteAsync Method (Object^)
Begins an asynchronous invitation operation for an endpoint to join a PeerCollaboration application sponsored by the sender of the invitation. The invitation is identified using the specified Object.
Assembly: System.Net (in System.Net.dll)
public: [SecurityCriticalAttribute] virtual void InviteAsync( Object^ userToken ) override
Parameters
- userToken
-
Type:
System::Object^
User-defined object to pass to the callback of the asynchronous operation. Also used to identify the asynchronous operation for cancellation. This parameter must be specified and is unique across all asynchronous invitation operations in progress.
| Exception | Condition |
|---|---|
| ArgumentException | UserToken cannot be null. |
| ObjectDisposedException | The PeerEndPoint object has been disposed. |
| PeerToPeerException |
|
The caller is not required to sign-in to the System.Net.PeerToPeer.Collaboration infrastructure for this method to complete successfully. A PeerInvitationResponse from the invitee is not the same as the invitee accepting the invitation to collaborate. If an invitation is sent to a remote peer that has not installed the application, the invitation is automatically declined.
Notes to Callers:
Additional overloads are defined on the Peer class instead of the subclasses PeerContact and PeerNearMe.
Calling this method requires a PermissionState of Unrestricted. This state is created when the peer collaboration session begins.
Available since 3.5