通过

peerGroupImportConfig 函数 (p2p.h)

  • 项目

PeerGroupImportConfig 函数根据提供的 XML 配置字符串中的特定设置导入标识的对等组配置。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupImportConfig(
  [in]  PCWSTR pwzXML,
  [in]  PCWSTR pwzPassword,
  [in]  BOOL   fOverwrite,
  [out] PWSTR  *ppwzIdentity,
  [out] PWSTR  *ppwzGroup
);

参数

[in] pwzXML

指定一个 Unicode 字符串，该字符串包含以前使用 PeerGroupExportConfig) 对等组配置导出的 (。 有关字符串的特定 XML 格式，请参阅本主题的“备注”部分。 此参数是必需的。

[in] pwzPassword

指定用于以 Unicode 字符串形式访问加密的对等组配置数据的密码。 此参数是必需的。

[in] fOverwrite

如果为 true，则覆盖现有组配置。 如果为 false，则仅当以前的组配置不存在时，才会写入组配置。 默认值为 false。 此参数是必需的。

[out] ppwzIdentity

包含导入完成后返回的对等标识。 此参数是必需的。

[out] ppwzGroup

包含导入完成后返回的对等组对等名称。 此参数是必需的。

返回值

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

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
E_OUTOFMEMORY
 内存不足，无法执行指定的操作。
PEER_E_ALREADY_EXISTS
 对等组配置已存在， 并且 fOverwrite 设置为 false。
 

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

注解

若要生成对等组配置，请调用 PeerGroupExportConfig，传入要导出的标识、密码和对等组的句柄。

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

<PEERGROUPCONFIG VERSION="1.0">
  <IDENTITYPEERNAME>
    <!-- UTF-8 encoded peer name of the identity -->
  </IDENTITYPEERNAME>
  <GROUPPEERNAME>
    <!-- UTF-8 encoded peer name of the peer 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 that contains 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 以及适用于 Windows XP 的高级网络包
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll