peerCollabSetEndpointName 函数 (p2p.h)

  • 项目

PeerCollabSetEndpointName 函数设置对等应用程序使用的当前终结点的名称。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetEndpointName(
  [in] PCWSTR pwzEndpointName
);

参数

[in] pwzEndpointName

指向当前终结点的新名称的指针，表示为以零结尾的 Unicode 字符串。 如果新名称与当前名称相同，则引发错误。 终结点名称限制为 255 个 Unicode 字符。

返回值

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

返回代码 说明
E_OUTOFMEMORY
 内存不足，无法支持此操作。
E_INVALIDARG
 其中一个参数无效。
PEER_E_NOT_SIGNED_IN
 该操作要求用户登录。

注解

默认情况下，终结点名称设置为计算机名称。 但是， 由 PeerCollabSetEndpointName 函数设置的新终结点名称将在重新启动后保留。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll

另请参阅

对等协作 API 函数