分组 API 函数

项目
03/13/2025

分组 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	将对等方的组配置导出为包含标识、组名称和 GMC 的 XML 字符串。
PeerGroupImportConfig	根据提供的 XML 配置字符串中的特定设置导入标识的对等组配置。