Peer::InviteAsyncCancel Method (Object^)
Cancels the invitation that was sent with the InviteAsync method.
Assembly: System.Net (in System.Net.dll)
Parameters
- userToken
-
Type:
System::Object^
User defined object to pass to the callback of the InviteAsync operation for identification. This required parameter must be unique across all asynchronous invitation operations in progress.
| Exception | Condition |
|---|---|
| ArgumentNullException | The userToken parameter cannot be null. |
| InvalidOperationException | An asynchronous invitation is not outstanding. |
Calling this method guarantees the system will cease to wait for a PeerInvitationResponse from the peer associated with the InviteAsync request.
Multiple invitations may be outstanding at any given time. If the InviteAsyncCancel method is called when an asynchronous operation identified by the userToken is not in existence, an exception is thrown. The userToken object must be provided since it is used to track a specific asynchronous call. This host application-supplied object is unique for each invite request.
When this method is used, the InviteCompleted event can still be raised, but the Cancelled property on the associated InviteCompletedEventArgs object will be set to true.
Calling this method requires a PermissionState of Unrestricted.
Available since 3.5