PeerGroupGetProperties 函数 (p2p.h)

PeerGroupGetProperties 函数检索有关指定组的属性的信息。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
  [in]  HGROUP                 hGroup,
  [out] PPEER_GROUP_PROPERTIES *ppProperties
);

[in] hGroup

检索其属性的对等组的句柄。此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。此参数是必需的。

[out] ppProperties

指向包含对等组属性相关信息的PEER_GROUP_PROPERTIES 结构的指针。必须使用 PeerFreeData 释放此数据。此参数是必需的。

如果操作成功，则返回 S_OK 。否则，函数将返回以下值之一。

返回代码	说明
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	没有足够的内存来执行指定的操作。
PEER_E_GROUP_NOT_READY	该组不处于可以检索对等组属性的状态。例如，调用 PeerGroupJoin ，但与组数据库的同步尚未完成。
PEER_E_INVALID_GROUP	对等组的句柄无效。

可以从 Microsoft RSA 基本提供程序返回特定于加密的错误。这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。

如果对等方未与对等组数据库同步，则无法检索组属性。若要在调用此函数之前与对等组数据库同步，请先调用 PeerGroupConnect。

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