图形 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	请求应用程序不再收到与对等图和记录类型关联的更改的通知。