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

Функция 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. Если экспорт выполнен успешно, приложение должно освободить ppwzExportXML , вызвав PeerFreeData.

Возвращаемое значение

Если вызов функции выполнен успешно, возвращаемое значение будет S_OK. В противном случае возвращается одно из следующих значений.

Код возврата Описание
E_INVALIDARG
 Один из параметров недопустим.
E_OUTOFMEMORY
 Недостаточно памяти для выполнения указанной операции.
PEER_E_NO_KEY_ACCESS
 Доступ к удостоверению однорангового узла или ключам группы одноранговых узлов был запрещен. Обычно это вызвано неправильным списком управления доступом (ACL) для папки, содержащей ключи пользователя или компьютера. Это может произойти при сбросе списка ACL вручную.
PEER_E_NOT_FOUND
Указанное удостоверение однорангового узла не существует.

Комментарии

Учетные данные членства в одноранговых группах не экспортируются. Экспортируется только одноранговая идентификация. Экспортированное одноранговое удостоверение можно импортировать на другой компьютер с помощью PeerIdentityImport.

Экспорт однорангового удостоверения не удаляет его из локального ccmputer, а создает его копию. Копию можно использовать для резервного копирования и восстановления однорангового удостоверения.

Фрагмент XML, используемый PeerIdentityExport , выглядит следующим образом:

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

Требования

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

См. также раздел

PEER_DATA

PeerFreeData

PeerIdentityImport