通过

peerGraphSetPresence 函数 (p2p.h)

  • 项目

PeerGraphSetPresence 函数显式打开或关闭特定节点的状态记录的发布。 此函数可以替代对等图属性中的状态设置。 调用此函数可以使用 PeerGraphEnumNodes 枚举节点。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSetPresence(
  [in] HGRAPH hGraph,
  [in] BOOL   fPresent
);

参数

[in] hGraph

对等图的句柄。

[in] fPresent

指定 TRUE 可强制对等图形基础结构为此节点发布状态记录，这会替代 PEER_GRAPH_PROPERTIES 中的 cPresenceMax 指定的设置。 指定 FALSE 将节点返回到对等图属性中指定的默认行为。

注意 根据对等图状态策略，将 fPresent 设置为 FALSE 并不能保证删除对等方的状态信息。 这意味着不再发布对等方的状态。
 

返回值

如果函数调用成功，则返回值 S_OK。 否则，它将返回以下值之一。

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
PEER_E_INVALID_GRAPH
 对等图的句柄无效。 无法发布状态信息。
PEER_E_NOT_INITIALIZED
 在使用此函数之前，必须通过调用 PeerGraphStartup 来初始化对等 图。

注解

如果对等图尚未显式发布状态信息，则枚举对等图时节点不可见。

要求

要求 值
最低受支持的客户端 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2PGraph.lib
DLL P2PGraph.dll

另请参阅

PeerGraphEnumNodes