图形 API 函数

对等图形 API 使用以下函数：

初始化和清理函数

函数	说明
PeerGraphShutdown	清理调用 PeerGraphStartup 分配的所有资源。
PeerGraphStartup	向对等图形基础结构指示调用应用程序所需的对等协议版本。

 

图形创建和访问函数

函数	说明
PeerGraphClose	使调用 PeerGraphCreate 或 PeerGraphOpen 返回的 对等图句柄失效，并关闭指定对等图的所有网络连接。
PeerGraphCreate	创建新的对等图。
PeerGraphDelete	删除与指定的对等图关联的数据。
PeerGraphListen	指示对等图应开始侦听传入连接。
PeerGraphOpen	打开以前由本地节点或远程节点创建的对等图。

 

图形和节点信息函数

函数	说明
PeerGraphEnumNodes	创建并返回一个枚举句柄，该句柄用于枚举对等图中的节点。
PeerGraphGetNodeInfo	检索有关特定节点的信息。
PeerGraphGetProperties	检索当前对等图属性。
PeerGraphGetStatus	返回对等图的当前状态。
PeerGraphSetNodeAttributes	设置本地节点的 PEER_NODE_INFO 结构的属性。
PeerGraphSetPresence	显式打开或关闭特定节点的状态记录的发布。 此函数可以替代对等图属性中的状态设置。
PeerGraphSetProperties	设置对等图属性。

 

记录管理功能

函数	说明
PeerGraphAddRecord	将新记录添加到对等图。 使用此函数添加的记录将发送到对等图中的每个节点。
PeerGraphDeleteRecord	在对等图中将记录标记为已删除。
PeerGraphEnumRecords	创建并返回一个枚举句柄，该句柄用于枚举特定类型的记录和/或用户。
PeerGraphGetRecord	根据指定的记录 ID 检索特定记录。
PeerGraphSearchRecords	在对等图中搜索特定记录。
PeerGraphUpdateRecord	在对等图中汇报一条记录，然后将该记录充值到对等图中的每个节点。
PeerGraphValidateDeferredRecords	向对等图形基础结构指示需要重新提交任何延迟的记录，以便安全模块进行验证。

 

导出和导入函数

函数	说明
PeerGraphExportDatabase	将对等图数据库导出到可以移动到其他计算机的文件中。
PeerGraphImportDatabase	导入包含对等图数据库中的信息的文件。

 

实用工具和支持函数

函数	说明
PeerGraphEndEnumeration	释放枚举句柄，并释放与枚举关联的资源。
PeerGraphFreeData	释放多个对等图形 API 函数返回的资源。
PeerGraphGetItemCount	检索枚举中的项数。
PeerGraphGetNextItem	获取通过调用特定函数创建的枚举中的下一项，这将返回对等枚举。
PeerGraphPeerTimeToUniversalTime	将对等图维护的引用时间值转换为适合在对等计算机上显示的本地化时间值。
PeerGraphUniversalTimeToPeerTime	将通用时间值从对等计算机转换为通用对等图时间值。

 

连接函数

函数	说明
PeerGraphCloseDirectConnection	关闭指定的直接连接。
PeerGraphConnect	尝试与对等图中的指定节点建立连接。 此函数启动异步操作。
PeerGraphEnumConnections	创建并返回用于枚举本地节点连接的枚举句柄。
PeerGraphOpenDirectConnection	允许应用程序与对等图中的节点建立直接连接。 仅当应用程序连接到的节点已订阅 PEER_GRAPH_EVENT_DIRECT_CONNECTION 事件时，才能建立 连接 。
PeerGraphSendData	将数据发送到相邻节点或直接连接的节点。

 

事件基础结构函数

函数	说明
PeerGraphGetEventData	检索对等事件。
PeerGraphRegisterEvent	注册对等方的请求，以便收到与对等图和事件类型关联的更改的通知。
PeerGraphUnregisterEvent	请求不再向应用程序通知与对等图和记录类型关联的更改。