PeerIdentityGetFriendlyName 函数 (p2p.h)

PeerIdentityGetFriendlyName 函数返回对等标识的友好名称。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetFriendlyName(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzFriendlyName
);

[in] pwzIdentity

指定用于获取友好名称的对等标识。

[out] ppwzFriendlyName

接收指向友好名称的指针。如果不再需要 ppwzFriendlyName ，则应用程序负责通过调用 PeerFreeData 释放此字符串。

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

返回代码	说明
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	没有足够的内存来执行指定的操作。
PEER_E_NO_KEY_ACCESS	拒绝访问对等标识或对等组密钥。通常，这是由于包含用户或计算机密钥的文件夹的 ACL) (访问控制列表不正确造成的。当 ACL 已手动重置时，可能会发生这种情况。
PEER_E_NOT_FOUND	找不到与指定名称匹配的对等标识。

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