PeerContact.Invite 方法

定义

命名空间:

System.Net.PeerToPeer.Collaboration

程序集:

System.Net.dll

发送加入由发送方发起的对等方协作活动的邀请。

重载

Invite(PeerApplication, String, Byte[])	发送加入由发送方发起的指定 PeerApplication 的指定邀请。
Invite(PeerEndPoint, PeerApplication, String, Byte[])	向指定 PeerEndPoint 发送指定的邀请，以使之加入由发送方发起的指定 PeerCollaboration 应用程序。
Invite()	发送加入由发送方发起的对等方协作的邀请。
Invite(PeerEndPoint)	向特定终结点发送邀请，以使之加入与邀请发送方之间的对等方协作。

注解

调用方无需登录到基础结构即可 System.Net.PeerToPeer.Collaboration 成功完成此方法。 PeerInvitationResponse来自被邀请的 与接受协作邀请的被邀请者不同。 如果邀请发送到未安装应用程序的远程对等方，则邀请将自动拒绝。

Invite(PeerApplication, String, Byte[])

发送加入由发送方发起的指定 PeerApplication 的指定邀请。

public:
 override System::Net::PeerToPeer::Collaboration::PeerInvitationResponse ^ Invite(System::Net::PeerToPeer::Collaboration::PeerApplication ^ applicationToInvite, System::String ^ message, cli::array <System::Byte> ^ invitationData);

[System.Security.SecurityCritical]
public override System.Net.PeerToPeer.Collaboration.PeerInvitationResponse Invite (System.Net.PeerToPeer.Collaboration.PeerApplication applicationToInvite, string message, byte[] invitationData);

[<System.Security.SecurityCritical>]
override this.Invite : System.Net.PeerToPeer.Collaboration.PeerApplication * string * byte[] -> System.Net.PeerToPeer.Collaboration.PeerInvitationResponse

Public Overrides Function Invite (applicationToInvite As PeerApplication, message As String, invitationData As Byte()) As PeerInvitationResponse

参数

applicationToInvite

PeerApplication

要向其发送邀请的 PeerApplication。

message

String

要与应用程序邀请一起发送到远程对等方的消息。

invitationData

Byte[]

与邀请关联的用户定义的数据 Blob。 其大小不能超过 16,384 字节。

返回

PeerInvitationResponse

从收到该邀请的对等方发出的 PeerInvitationResponse。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerApplication 不能为 null。

ObjectDisposedException

PeerEndPoint 对象已释放。

PeerToPeerException

当前应用程序的 Id 不存在或为空。

注解

调用方无需登录到基础结构即可 System.Net.PeerToPeer.Collaboration 成功完成此方法。 PeerInvitationResponse来自被邀请的 与接受协作邀请的被邀请者不同。 如果邀请发送到未安装应用程序的远程对等方，则邀请将自动拒绝。

调用此方法需要 的 PermissionStateUnrestricted。 此状态是在对等协作会话开始时创建的。

调用方说明

调用此方法需要 的 PermissionStateUnrestricted。 此状态是在对等协作会话开始时创建的。

另请参阅

• GetApplications
• Id
• Subscribe()

Invite(PeerEndPoint, PeerApplication, String, Byte[])

向指定 PeerEndPoint 发送指定的邀请，以使之加入由发送方发起的指定 PeerCollaboration 应用程序。

public:
 System::Net::PeerToPeer::Collaboration::PeerInvitationResponse ^ Invite(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, System::Net::PeerToPeer::Collaboration::PeerApplication ^ applicationToInvite, System::String ^ message, cli::array <System::Byte> ^ invitationData);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerInvitationResponse Invite (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, System.Net.PeerToPeer.Collaboration.PeerApplication applicationToInvite, string message, byte[] invitationData);

[<System.Security.SecurityCritical>]
override this.Invite : System.Net.PeerToPeer.Collaboration.PeerEndPoint * System.Net.PeerToPeer.Collaboration.PeerApplication * string * byte[] -> System.Net.PeerToPeer.Collaboration.PeerInvitationResponse

Public Function Invite (peerEndPoint As PeerEndPoint, applicationToInvite As PeerApplication, message As String, invitationData As Byte()) As PeerInvitationResponse

参数

peerEndPoint

PeerEndPoint

要向其发送邀请的终结点或远程对等方。

applicationToInvite

PeerApplication

要为其发送邀请的应用程序。

message

String

要与应用程序邀请一起发送到远程对等方的消息。 消息的长度不能超过 255 个 Unicode 字符。

invitationData

Byte[]

与邀请关联的用户定义的数据 Blob。 其大小不能超过 16,384 字节。

返回

PeerInvitationResponse

从收到该邀请的对等方发出的 PeerInvitationResponse。

属性

SecurityCriticalAttribute

例外

ArgumentException

PeerEndPoint 中的终结点不能为 null。

ArgumentNullException

• PeerApplication 对象不能为空。

• PeerApplication 和 PeerEndPoint 对象不能为 null对象。

ObjectDisposedException

PeerEndPoint 对象已释放。

PeerToPeerException

当前应用程序的 Id 不存在或为空。

注解

调用方无需登录到基础结构即可 System.Net.PeerToPeer.Collaboration 成功完成此方法。 PeerInvitationResponse来自被邀请的 与接受协作邀请的被邀请者不同。 如果邀请发送到未安装应用程序的远程对等方，则邀请将自动拒绝。

调用方说明

调用此方法需要 的 PermissionStateUnrestricted。 此状态是在对等协作会话开始时创建的。

另请参阅

• GetApplications
• Subscribe()

Invite()

发送加入由发送方发起的对等方协作的邀请。

public:
 override System::Net::PeerToPeer::Collaboration::PeerInvitationResponse ^ Invite();

[System.Security.SecurityCritical]
public override System.Net.PeerToPeer.Collaboration.PeerInvitationResponse Invite ();

[<System.Security.SecurityCritical>]
override this.Invite : unit -> System.Net.PeerToPeer.Collaboration.PeerInvitationResponse

Public Overrides Function Invite () As PeerInvitationResponse

返回

PeerInvitationResponse

从收到该邀请的对等方发出的 PeerInvitationResponse。

属性

SecurityCriticalAttribute

例外

ObjectDisposedException

PeerEndPoint 对象已释放。

PeerToPeerException

不存在当前应用程序的 Id。

注解

调用方无需登录到基础结构即可 System.Net.PeerToPeer.Collaboration 成功完成此方法。 PeerInvitationResponse来自被邀请的 与接受协作邀请的被邀请者不同。 如果邀请发送到未安装应用程序的远程对等方，则邀请将自动拒绝。

调用方说明

调用此方法需要 的 PermissionStateUnrestricted。 此状态是在对等协作会话开始时创建的。

另请参阅

• GetApplications
• InviteCompleted
• Subscribe()

Invite(PeerEndPoint)

向特定终结点发送邀请，以使之加入与邀请发送方之间的对等方协作。

public:
 System::Net::PeerToPeer::Collaboration::PeerInvitationResponse ^ Invite(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerInvitationResponse Invite (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint);

[<System.Security.SecurityCritical>]
override this.Invite : System.Net.PeerToPeer.Collaboration.PeerEndPoint -> System.Net.PeerToPeer.Collaboration.PeerInvitationResponse

Public Function Invite (peerEndPoint As PeerEndPoint) As PeerInvitationResponse

参数

peerEndPoint

PeerEndPoint

将收到邀请的终结点。

返回

PeerInvitationResponse

从收到该邀请的对等终结点发出的 PeerInvitationResponse。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerEndPoint 不能为 null。

ObjectDisposedException

PeerEndPoint 对象已释放。

PeerToPeerException

• 无法完成 Invite() 操作。

• 当前正在执行的应用程序未注册到对等协作基础结构。

• EndPoint由 对象指定的 PeerEndPoint 无效。

注解

调用方无需登录到基础结构即可 System.Net.PeerToPeer.Collaboration 成功完成此方法。 PeerInvitationResponse来自被邀请的 与接受协作邀请的被邀请者不同。 如果邀请发送到未安装应用程序的远程对等方，则邀请将自动拒绝。

调用方说明

调用此方法需要 的 PermissionStateUnrestricted。 此状态是在对等协作会话开始时创建的。

另请参阅

• GetApplications
• Id
• Subscribe()