PeerContact.GetApplications 方法

定义

命名空间:

System.Net.PeerToPeer.Collaboration

程序集:

System.Net.dll

检索远程对等方在本地缓存中注册的 PeerApplication 对象。

重载

GetApplications()	检索远程对等方在本地缓存中注册的 PeerApplication 对象。
GetApplications(Guid)	从本地缓存中获取具有指定 PeerApplication 的 Guid 对象的集合。
GetApplications(PeerEndPoint)	获取与指定 PeerApplicationCollection 关联的 PeerEndPoint。
GetApplications(PeerEndPoint, Guid)	获取与指定 PeerApplicationCollection 关联的 PeerEndPoint。

注解

此功能仅在 类上 PeerContact 公开。 出于安全原因，此功能不会在任何其他类型的对等上公开。

GetApplications()

检索远程对等方在本地缓存中注册的 PeerApplication 对象。

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications();

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications ();

[<System.Security.SecurityCritical>]
member this.GetApplications : unit -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications () As PeerApplicationCollection

返回

PeerApplicationCollection

本地缓存中的 PeerApplicationCollection。 如果未找到与 PeerEndPoint 关联的应用程序，则返回一个大小为零 (0) 的集合。

属性

SecurityCriticalAttribute

例外

InvalidOperationException

• 调用对等方未订阅 PeerEndPoint。

• 调用对等方尚未调用 RefreshData() 方法。

PeerToPeerException

无法完成 GetApplications() 操作。

注解

如果调用对等方未订阅与 PeerContact 指定 PeerEndPointRefreshData 关联的 ，则必须在调用此方法之前调用方法。

虽然调用方无需登录到协作基础结构即可成功完成此方法，但对 或方法之Subscribe一的成功调用RefreshData必须在调用方之前登录时完成。

此功能仅在 类上 PeerContact 公开。 出于安全原因，此功能不会在任何其他类型的对等上公开。

调用方说明

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

GetApplications(Guid)

从本地缓存中获取具有指定 PeerApplication 的 Guid 对象的集合。

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications(Guid applicationId);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications (Guid applicationId);

[<System.Security.SecurityCritical>]
member this.GetApplications : Guid -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications (applicationId As Guid) As PeerApplicationCollection

参数

applicationId

Guid

要检索的对等应用程序的 Guid。

返回

PeerApplicationCollection

本地缓存中的 PeerApplicationCollection。 如果未找到具有指定 applicationId 的任何应用程序，则返回一个大小为零 (0) 的集合。

属性

SecurityCriticalAttribute

例外

InvalidOperationException

• 调用对等方未订阅 PeerEndPoint。

• 调用对等方尚未调用 RefreshData() 方法。

PeerToPeerException

无法完成 GetApplications() 操作。

注解

如果调用对等方未订阅与 PeerContact 指定 PeerEndPointRefreshData 关联的 ，则必须在调用此方法之前调用方法。

虽然调用方无需登录到协作基础结构即可成功完成此方法，但对 或方法之Subscribe一的成功调用RefreshData必须在调用方之前登录时完成。

此功能仅在 类上 PeerContact 公开。 出于安全原因，此功能不会在任何其他类型的对等上公开。

调用方说明

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

另请参阅

• PeerApplicationLaunchInfo

GetApplications(PeerEndPoint)

获取与指定 PeerApplicationCollection 关联的 PeerEndPoint。

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint);

[<System.Security.SecurityCritical>]
member this.GetApplications : System.Net.PeerToPeer.Collaboration.PeerEndPoint -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications (peerEndPoint As PeerEndPoint) As PeerApplicationCollection

参数

peerEndPoint

PeerEndPoint

包含与 PeerContact 关联的终结点信息。

返回

PeerApplicationCollection

与指定 PeerApplicationCollection 关联的 PeerEndPoint。 如果没有与指定 PeerEndPoint 关联的应用程序，则返回一个大小为零 (0) 的集合。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerEndPoint 不能为 null。

InvalidOperationException

• 调用对等方未订阅 PeerEndPoint。

• 调用对等方尚未调用 RefreshData() 方法。

PeerToPeerException

无法完成 GetApplications() 操作。

注解

如果调用对等方未订阅与 PeerContact 指定 PeerEndPointRefreshData 关联的 ，则必须在调用此方法之前调用方法。

虽然调用方无需登录到协作基础结构即可成功完成此方法，但对 或方法之Subscribe一的成功调用RefreshData必须在调用方之前登录时完成。

此功能仅在 类上 PeerContact 公开。 出于安全原因，此功能不会在任何其他类型的对等上公开。

调用方说明

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

另请参阅

• PeerApplicationLaunchInfo
• RegisterApplication(PeerApplication, PeerApplicationRegistrationType)

GetApplications(PeerEndPoint, Guid)

获取与指定 PeerApplicationCollection 关联的 PeerEndPoint。

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, Guid applicationId);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, Guid applicationId);

[<System.Security.SecurityCritical>]
member this.GetApplications : System.Net.PeerToPeer.Collaboration.PeerEndPoint * Guid -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications (peerEndPoint As PeerEndPoint, applicationId As Guid) As PeerApplicationCollection

参数

peerEndPoint

PeerEndPoint

与 PeerApplicationCollection 关联的终结点。

applicationId

Guid

包含与 PeerContact 关联的应用程序信息。

返回

PeerApplicationCollection

与 PeerApplication 关联的 PeerEndPoint 对象的集合。

如果未为 PeerEndPoint 找到由该 ID 标识的应用程序，或者终结点的 ID 为 null 或无效，则返回一个大小为零 (0) 的集合。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerEndPoint 不能为 null。

InvalidOperationException

• 调用对等方未订阅 PeerEndPoint。

• 调用对等方尚未调用 RefreshData() 方法。

PeerToPeerException

无法完成 GetApplications() 操作。

注解

如果调用对等方未订阅与 PeerContact 指定 PeerEndPointRefreshData 关联的 ，则必须在调用此方法之前调用方法。

虽然调用方无需登录到协作基础结构即可成功完成此方法，但对 或方法之Subscribe一的成功调用RefreshData必须在调用方之前登录时完成。

此功能仅在 类上 PeerContact 公开。 出于安全原因，此功能不会在任何其他类型的对等上公开。

调用方说明

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

另请参阅

• GetObjectData(SerializationInfo, StreamingContext)
• Invite
• PeerApplicationLaunchInfo