peerCreatePeerName 函数 (p2p.h)

PeerCreatePeerName 函数基于指定对等标识和分类器的现有名称创建新名称。 但是,调用 PeerCreatePeerName 不会创建新标识。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzClassifier,
  [out] PWSTR  *ppwzPeerName
);

参数

[in] pwzIdentity

指定要用作新对等名称的基础的标识。 如果 pwzIdentityNULL,则创建的名称不基于任何对等标识,因此是不安全的名称。

如果 pwzClassifier为 NULL,则此参数只能为 NULL

[in] pwzClassifier

指向包含新分类器的 Unicode 字符串的指针。 此分类器追加到指定标识的对等名称的现有颁发机构部分。 此字符串长度为 150 个字符,包括 NULL 终止符。 指定 NULL 可返回标识的对等名称。

仅当 pwzIdentity 不为 NULL 时,此参数才能为 NULL

[out] ppwzPeerName

接收指向新对等名称的指针的指针。 如果不再需要此字符串,请通过调用 PeerFreeData 将其释放。

返回值

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

返回代码 说明
E_INVALIDARG
其中一个参数无效。
E_OUTOFMEMORY
内存不足,无法执行指定的操作。

注解

在调用 PeerCreatePeerName 函数之前,必须将参数 ppwzPeername 设置为 null。

要求

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

另请参阅

PeerFreeData