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

Функция 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 сбрасывается вручную.
 

Ошибки, связанные с шифрованием, могут быть возвращены поставщиком базовых служб шифрования Майкрософт. Эти ошибки имеют префикс 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>

Требования

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