通过

peerIdentitySetFriendlyName 函数 (p2p.h)

  • 项目

PeerIdentitySetFriendlyName 函数修改指定对等标识的友好名称。 友好名称是用户可读的名称。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentitySetFriendlyName(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzFriendlyName
);

参数

[in] pwzIdentity

指定要修改的对等标识。

[in] pwzFriendlyName

指定新的友好名称。 指定 NULL 或空字符串，将友好名称重置为默认值，即对等名称的 Unicode 版本。

返回值

如果函数调用成功，则返回值 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

另请参阅

PeerIdentityGetFriendlyName