PeerCollabGetEndpointName 函数 (p2p.h)

PeerCollabGetEndpointName 函数检索调用对等方当前终结点的名称,如之前调用 PeerCollabSetEndpointName 设置的那样。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetEndpointName(
  [out] PWSTR *ppwzEndpointName
);

参数

[out] ppwzEndpointName

指向调用应用程序当前使用的对等终结点的零终止 Unicode 字符串名称的指针。

返回值

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

返回代码 说明
E_OUTOFMEMORY
没有足够的内存来支持此操作。
E_INVALIDARG
其中一个参数无效。
PEER_E_NOT_INITIALIZED
Windows 对等基础结构未初始化。 需要调用相关的初始化函数。
PEER_E_NOT_SIGNED_IN
该操作要求用户登录。

注解

终结点名称限制为 25 个 Unicode 字符。 若要释放此数据,请调用 PeerFreeData

要求

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

另请参阅

对等协作 API 函数

PeerCollabSetEndpointName