通过

PeerIdentityExport 函数 (p2p.h)

  • 项目

PeerIdentityExport 函数允许用户导出一个对等标识。 然后，用户可以将对等标识传输到其他计算机。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityExport(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzExportXML
);

参数

[in] pwzIdentity

指定要导出的对等标识。 此参数是必需的，没有默认值。

[in] pwzPassword

指定用于加密对等标识的密码。 此参数不能为 NULL。 还必须使用此密码导入对等标识，否则导入操作将失败。

[out] ppwzExportXML

接收指向 XML 格式导出的对等标识的指针。 如果导出操作成功，则应用程序必须通过调用 PeerFreeData 释放 ppwzExportXML。

返回值

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

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
E_OUTOFMEMORY
 没有足够的内存来执行指定的操作。
PEER_E_NO_KEY_ACCESS
 拒绝访问对等标识或对等组密钥。 这通常是由包含用户或计算机密钥的文件夹 (ACL) 不正确的访问控制列表引起的。 手动重置 ACL 时，可能会发生这种情况。
PEER_E_NOT_FOUND
指定的对等标识不存在。

注解

不会导出对等组成员身份凭据。 仅导出一个对等标识。 可以使用 PeerIdentityImport 在另一台计算机上导入导出的对等标识。

导出对等标识不会从本地 ccmputer 中删除它，它会复制它。 副本可用于备份和还原对等标识。

PeerIdentityExport 使用的 XML 片段如下所示：

<PEERIDENTITYEXPORT VERSION="1.0">
   <PEERNAME>
     <!-- UTF-8 encoded peer name of the identity -->
   </PEERNAME>
   <DATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </DATA>
</PEERIDENTITYEXPORT>

要求

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

另请参阅

PEER_DATA

PeerFreeData

PeerIdentityImport