Поделиться через

Функция 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

Указывает строку Юникода, содержащую ранее экспортированную (с помощью PeerGroupExportConfig) конфигурацию одноранговой группы. Конкретный формат XML строки см. в разделе Примечания этого раздела. Это обязательный параметр.

[in] pwzPassword

Указывает пароль, используемый для доступа к зашифрованным данным конфигурации группы одноранговых узлов, в виде строки Юникода. Это обязательный параметр.

[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>

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header p2p.h
Библиотека P2P.lib
DLL P2P.dll