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。 否则,它将返回以下值之一。
返回代码 | 说明 |
---|---|
|
无法访问对等图。 |
|
其中一个参数无效。 |
|
对等图的句柄无效。 |
|
必须先通过调用 PeerGraphStartup 初始化图形,然后才能使用此函数。 |
注解
可以修改PEER_GRAPH_PROPERTIES结构的 pwzFriendlyName、cPresenceMax、pwzComment 和 ulPresenceLifetime 成员。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 具有 SP2 的 Windows XP [仅限桌面应用],具有 SP1 的 Windows XP 与高级网络包 forWindows XP |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | p2p.h |
Library | P2PGraph.lib |
DLL | P2PGraph.dll |