通过

peerIdentityGetXML 函数 (p2p.h)

  • 项目

PeerIdentityGetXML 函数返回对等标识的说明，该说明随后可以传递给第三方，并用于邀请对等标识加入对等组。 此信息作为 XML 片段返回。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetXML(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzIdentityXML
);

parameters

[in] pwzIdentity

指定要为其检索对等标识信息的对等标识。 当此参数作为 NULL 传递时，对等基础结构将为用户生成“默认”标识。

[out] ppwzIdentityXML

指向指向包含 XML 片段的 Unicode 字符串的指针的指针。 当不再需要 ppwzIdentityXML 时，应用程序负责通过调用 PeerFreeData 释放此字符串。

返回值

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

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

注解

返回的 XML 片段具有以下结构：

<PEERIDENTITYINFO VERSION="1.0">
     <IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
          Base 64 encoded certificate.
     </IDC>
</PEERIDENTITYINFO>

创建加入组的邀请时使用此 XML 片段。

不允许应用程序在 PEERIDENTITYINFO 标记中添加标记，也不允许以任何方式修改此 XML 片段。 允许应用程序将此 XML 片段合并到其他 XML 文档中，但在将此片段传递到 PeerGroupCreateInvitation 之前，必须去除所有特定于应用程序的 XML。

要求

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

请参阅

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation