peerGroupSetProperties 函数 (p2p.h)
PeerGroupSetProperties 函数设置当前的对等组属性。 在此 API 版本 1.0 中，只有对等组的创建者才能执行此操作。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
[in] HGROUP hGroup,
[in] PPEER_GROUP_PROPERTIES pProperties
);
参数
[in] hGroup
对等组的句柄，该组的属性由对等方设置。 此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。 此参数是必需的。
[in] pProperties
指向包含新属性的对等填充 PEER_GROUP_PROPERTIES 结构的指针。 若要获取此结构，对等必须首先调用 PeerGroupGetProperties，更改相应的字段，然后将其作为此参数传递。 此参数是必需的。
无法更改 PEER_GROUP_PROPERTIES 的以下成员：
- dwSize
- pwzCloud
- pwzClassifier
- pwzGroupPeerName
- pwzCreatorPeerName
返回值
如果操作成功，则返回 S_OK 。 否则，该函数返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
内存不足，无法完成操作。 |
|
组未处于可设置对等组属性的状态。 例如，已调用 PeerGroupJoin ，但与对等组数据库的同步未完成。 |
|
对等组的句柄无效。 |
|
一个或多个指定的属性无效。 |
|
当前标识无权更改这些属性。 在这种情况下，标识不是对等组的创建者。 |
|
指定的密码不符合系统密码要求。 |
可以从 Microsoft RSA 基础提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。
注解
对于使用密码的应用程序，建议通过调用 CryptoProtectMemory 和 SecureZeroMemory 函数安全地处理密码。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包 |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2P.lib |
| DLL | P2P.dll |