通过

PeerGroupExportConfig 函数 (p2p.h)

  • 项目

PeerGroupExportConfig 函数将对等方的组配置导出为 XML 字符串，其中包含标识的标识、组名称和 GMC。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupExportConfig(
  [in]  HGROUP hGroup,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzXML
);

参数

[in] hGroup

组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。 此参数是必需的。

[in] pwzPassword

指定用于保护导出的配置的密码。 此密码的形成没有规则或限制。 此参数是必需的。

[out] ppwzXML

指向返回的 XML 配置字符串的指针，该字符串包含标识的标识、组对等名称、云对等名称、组范围和 GMC。 此参数是必需的。

返回值

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

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

可以从 Microsoft 基本加密提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。

注解

导出后，可将此配置从带外传递到另一对等方，在其中可以建立标识的配置。 若要导入配置，请将此函数返回的 XML 字符串与其上设置的密码传递给 PeerGroupImportConfig。

配置 XML 字符串以以下格式显示：

<PEERGROUPCONFIG VERSION="1.0">
  <IDENTITYPEERNAME>
    <!-- UTF-8 encoded peer name of the identity -->
  </IDENTITYPEERNAME>
  <GROUPPEERNAME>
    <!-- UTF-8 encoded peer name of the group -->
  </GROUPPEERNAME>
  <CLOUDNAME>
    <!-- UTF-8 encoded Unicode name of the cloud -->
  </CLOUDNAME>
  <SCOPE>
    <!-- UTF-8 encoded Unicode name of the scope: global, site-local, link-local -->
  </SCOPE>
  <CLOUDFLAGS>
    <!-- A DWORD containing cloud-specific settings, represented as a string -->
  </CLOUDFLAGS>
  <GMC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
    <!-- base64/PKCS7 encoded GMC chain -->
  </GMC>
</PEERGROUPCONFIG>

要求

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