peerCreatePeerName 函数 (p2p.h)
PeerCreatePeerName 函数基于指定对等标识和分类器的现有名称创建新名称。 但是,调用 PeerCreatePeerName 不会创建新标识。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzClassifier,
[out] PWSTR *ppwzPeerName
);
参数
[in] pwzIdentity
指定要用作新对等名称的基础的标识。 如果 pwzIdentity 为 NULL,则创建的名称不基于任何对等标识,因此是不安全的名称。
如果 pwzClassifier 不为 NULL,则此参数只能为 NULL。
[in] pwzClassifier
指向包含新分类器的 Unicode 字符串的指针。 此分类器追加到指定标识的对等名称的现有颁发机构部分。 此字符串长度为 150 个字符,包括 NULL 终止符。 指定 NULL 可返回标识的对等名称。
仅当 pwzIdentity 不为 NULL 时,此参数才能为 NULL。
[out] ppwzPeerName
接收指向新对等名称的指针的指针。 如果不再需要此字符串,请通过调用 PeerFreeData 将其释放。
返回值
如果函数调用成功,则返回值 S_OK。 否则,它将返回以下值之一。
返回代码 | 说明 |
---|---|
|
其中一个参数无效。 |
|
内存不足,无法执行指定的操作。 |
注解
在调用 PeerCreatePeerName 函数之前,必须将参数 ppwzPeername 设置为 null。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 带 SP2 的 Windows XP [仅限桌面应用],带 SP1 的 Windows XP 和适用于 Windows XP 的高级网络包 |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | p2p.h |
Library | P2P.lib |
DLL | P2P.dll |