Peer::Invite Method (PeerApplication^, String^, array<Byte>^)
Sends an invitation to a Peer to start a specific PeerApplication.
Assembly: System.Net (in System.Net.dll)
public: virtual PeerInvitationResponse^ Invite( PeerApplication^ applicationToInvite, String^ message, array<unsigned char>^ invitationData ) abstract
Parameters
- applicationToInvite
-
Type:
System.Net.PeerToPeer.Collaboration::PeerApplication^
The PeerApplication for which the invitation is sent.
- message
-
Type:
System::String^
A message to send to the remote peer along with the application invitation. The message can be no more than 255 Unicode characters.
- invitationData
-
Type:
array<System::Byte>^
A user defined data blob to associate with the invitation. Its size can be no more than 16,384 bytes.
Return Value
Type: System.Net.PeerToPeer.Collaboration::PeerInvitationResponse^A PeerInvitationResponse from the peer that received the invitation.
| Exception | Condition |
|---|---|
| ArgumentException | The application is not registered for collaboration. |
| ArgumentOutOfRangeException | invitationData is larger than 16,384 bytes. |
| PeerToPeerException |
|
Calling this method requires a PermissionState of Unrestricted. This state is created when the peer collaboration session begins.
Available since 3.5