分组 API 函数
分组 API 使用以下函数：
组初始化和清理函数
| 函数 | 说明 |
|---|---|
| PeerGroupShutdown | 关闭使用 PeerGroupStartup 创建的对等 组，并释放任何分配的资源。 |
| PeerGroupStartup | 使用请求的对等基础结构版本启动对等组。 |
组创建和访问函数
| 函数 | 说明 |
|---|---|
| PeerGroupClose | 使先前调用 PeerGroupCreate、PeerGroupJoin 或 PeerGroupOpen 函数获得的对等组句柄失效。 |
| PeerGroupConnect | 启动对等组的 PNRP 搜索并尝试连接到该组。 成功调用此函数后，对等方可以与对等组的其他成员通信。 |
| PeerGroupConnectByAddress | 尝试连接到具有已知 IPv6 地址的其他对等方正在参与的对等组。 |
| PeerGroupCreate | 创建新的对等组。 |
| PeerGroupCreateInvitation | 返回一个 XML 字符串，指定的对等方可以使用该字符串加入组。 |
| PeerGroupCreatePasswordInvitation | 返回一个 XML 字符串，指定的对等方可以使用该字符串来联接具有匹配密码的组。 |
| PeerGroupDelete | 删除与对等组关联的本地数据和证书。 |
| PeerGroupGetStatus | 检索组的当前状态。 |
| PeerGroupIssueCredentials | 向特定标识颁发凭据（包括 GMC），并选择性地返回受邀对等方可用于加入对等组的邀请 XML 字符串。 |
| PeerGroupJoin | 允许具有邀请的对等方加入现有对等组。 |
| PeerGroupOpen | 打开对等方已创建或加入的对等组。 |
| PeerGroupParseInvitation | 返回包含特定邀请详细信息 的PEER_INVITATION_INFO 结构。 |
| PeerGroupPasswordJoin | 允许具有邀请和正确密码的对等方加入受密码保护的对等组。 |
组和成员信息函数
| 函数 | 说明 |
|---|---|
| PeerGroupEnumMembers | 创建可用对等组成员和关联的成员身份信息的枚举。 |
| PeerGroupGetProperties | 检索有关指定组的属性的信息。 |
| PeerGroupSetProperties | 设置当前对等组属性。 在此 API 版本 1.0 中，只有对等组的创建者才能执行此操作。 |
记录和记录管理功能
| 函数 | 说明 |
|---|---|
| PeerGroupAddRecord | 将新记录添加到对等组，该记录将传播到所有参与的对等方。 |
| PeerGroupDeleteRecord | 从对等组中删除记录。 只有记录的创建者才能将其删除。 |
| PeerGroupEnumRecords | 创建对等组记录的枚举。 |
| PeerGroupGetRecord | 检索特定组记录。 |
| PeerGroupSearchRecords | 在本地对等组数据库中搜索与所提供的条件匹配的记录。 |
| PeerGroupUpdateRecord | 汇报特定对等组中的记录。 |
组数据库导入/导出函数
| 函数 | 说明 |
|---|---|
| PeerGroupExportDatabase | 将对等组数据库导出到特定文件，该文件可以传输到另一台计算机，并使用 PeerGroupImportDatabase 函数导入。 |
| PeerGroupImportDatabase | 从本地文件导入对等组数据库。 |
直接连接函数
| 函数 | 说明 |
|---|---|
| PeerGroupCloseDirectConnection | 关闭两个对等机之间的特定直接连接。 |
| PeerGroupEnumConnections | 创建对等方上当前处于活动状态的连接枚举。 |
| PeerGroupOpenDirectConnection | 与对等组中的另一个对等方建立直接连接。 |
| PeerGroupSendData | 通过邻居或直接连接将数据发送到成员。 |
组事件基础结构
| 函数 | 说明 |
|---|---|
| PeerGroupGetEventData | 允许应用程序检索分组事件返回的数据。 |
| PeerGroupRegisterEvent | 为特定的对等组事件注册对等。 |
| PeerGroupUnregisterEvent | 从与提供的事件句柄关联的对等事件通知中注销对等方。 |
组时间转换函数
| 函数 | 说明 |
|---|---|
| PeerGroupPeerTimeToUniversalTime | 将对等组维护的引用时间值转换为适合在对等计算机上显示的本地化时间值。 |
| PeerGroupUniversalTimeToPeerTime | 将本地时间值从对等计算机转换为公用对等组时间值。 |
组配置函数
| 函数 | 说明 |
|---|---|
| PeerGroupExportConfig | 将对等方的组配置导出为 XML 字符串，其中包含标识的标识、组名称和 GMC。 |
| PeerGroupImportConfig | 根据提供的 XML 配置字符串中的特定设置导入标识的对等组配置。 |