PeerCollaboration 类

定义

与对等方协作基础结构进行交互。 很多核心协作方案都是从此类着手的。

public ref class PeerCollaboration abstract sealed
public static class PeerCollaboration
type PeerCollaboration = class
Public Class PeerCollaboration
继承
PeerCollaboration

注解

此类是静态类 - 它是密封的、抽象的,没有公共构造函数。 它用于包含和管理已接受协作会话邀请的对等方的应用程序、对象和状态信息。 在对等、对象和应用程序方面,PeerCollaboration 类提供三个访问器,每个集合一个访问器,作为计算机上发生的任何其他事件的接口或连接点。 此类不能继承;如果将此密封类指定为基类,则会发生编译时错误。

此类中的方法和属性可用于:

  • 启动和管理协作应用程序

  • 注册和删除应用程序和协作对象 (,例如证书、图片、头像和文本说明)

  • 邀请对等方参加协作会话,包括范围和对象等项,这些项将通过 Internet 标识它们

  • 允许对等方进入 SignIn 协作基础结构, SignOut 管理联系人列表,或彼此发布其状态

  • 利用 SynchronizingObject 属性和事件来协调异步应用程序通信,尤其是名称、状态、应用程序或其他对象的更改。

“Link-local cloud”、“subnet of the calling peer”和“NearMe scope”是同义词。 “Internet 范围”和“无服务器状态”是同义词。 站点本地 PnrpScope 在协作命名空间中没有等效项。

在此类中使用每个方法或属性都需要 PermissionStateUnrestricted。 此状态是在对等协作会话开始时创建的。

属性

ApplicationLaunchInfo

获取 PeerApplicationLaunchInfo 对象,该对象包含应用程序在远程对等方的协作请求下启动时所需的信息。

ContactManager

获取包含远程对等方的所有 PeerContact 对象的持久性存储区。

LocalEndPointName

获取或设置与调用对等方关联的 PeerEndPoint 的名称。

LocalPresenceInfo

获取或设置调用对等方在 PeerCollaboration 基础结构中的状态。

SignInScope

获取调用对等方可在其中发布状态、功能和对象信息的 PeerScope

SynchronizingObject

获取或设置所有事件处理程序的事件处理程序回调对象。

方法

DeleteObject(PeerObject)

注销与调用对等相关联的 PeerObject

GetLocalRegisteredApplications()

获取在本地计算机上注册的所有 PeerApplication 对象。

GetLocalRegisteredApplications(PeerApplicationRegistrationType)

获取在本地计算机上为指定 PeerApplication 注册的所有 PeerApplicationRegistrationType 对象的集合。

GetLocalSetObjects()

获取调用对等方在此计算机的 PeerObject 基础结构中注册的所有 PeerCollaboration 实例。

GetPeersNearMe()

返回一个集合,其中包含当前在调用对等方的网络子网中登录的所有 PeerCollaboration 终结点。

RegisterApplication(PeerApplication, PeerApplicationRegistrationType)

注册指定的 PeerApplication,可用于通过调用对等进行协作会话。

SetObject(PeerObject)

注册与调用对等相关联的 PeerObject

SignIn(PeerScope)

让对等方以指定的 PeerScope 登录协作基础结构。

SignOut(PeerScope)

从指定范围注销对等方。

UnregisterApplication(PeerApplication, PeerApplicationRegistrationType)

PeerCollaboration 基础结构中注销指定的 PeerApplication

事件

LocalApplicationChanged

当本地主机上的本地对等方的 PeerApplication 中有 PeerApplicationCollection 发生更改时引发。

LocalNameChanged

当本地对等方所在的本地主机上的 PeerEndPoint 名称更改时引发。

LocalObjectChanged

在本地主机上,本地对等方的 PeerObject 中有一个 PeerObjectCollection 已发生更改。

LocalPresenceChanged

在本地主机上,本地对等方的 PeerPresenceInfo 已更改。

适用于