PeerGraphSetProperties 函数 (p2p.h)

PeerGraphSetProperties 函数设置对等图属性。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSetProperties(
  [in] HGRAPH                 hGraph,
  [in] PPEER_GRAPH_PROPERTIES pGraphProperties
);

参数

[in] hGraph

图形的句柄。

[in] pGraphProperties

指向 PEER_GRAPH_PROPERTIES 结构的指针,该结构指定应用程序可以设置的图形属性的新值。

应用程序只能设置 PEER_GRAPH_PROPERTIES的以下字段:

  • pwzFriendlyName
  • cPresenceMax
  • pwzComment
  • ulPresenceLifetime
注意 如果设置了剩余字段,则忽略这些字段。
 

返回值

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

返回代码 说明
E_ACCESSDENIED
无法访问对等图。
E_INVALIDARG
其中一个参数无效。
PEER_E_INVALID_GRAPH
对等图的句柄无效。
PEER_E_NOT_INITIALIZED
必须先通过调用 PeerGraphStartup 初始化图形,然后才能使用此函数。

注解

可以修改PEER_GRAPH_PROPERTIES结构的 pwzFriendlyNamecPresenceMaxpwzCommentulPresenceLifetime 成员。

要求

要求
最低受支持的客户端 具有 SP2 的 Windows XP [仅限桌面应用],具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2PGraph.lib
DLL P2PGraph.dll

另请参阅

PEER_GRAPH_PROPERTIES

PeerGraphCreate

PeerGraphGetProperties