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

Функция PeerIdentityImport (p2p.h)

  • Статья

Функция PeerIdentityImport импортирует одноранговые удостоверения. Если удостоверение однорангового узла существует на компьютере, возвращается PEER_E_ALREADY_EXISTS .

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityImport(
  [in]  PCWSTR pwzImportXML,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzIdentity
);

Параметры

[in] pwzImportXML

Указатель на удостоверение однорангового узла формата XML для импорта, которое возвращается PeerIdentityExport. Эти двоичные данные должны соответствовать экспортируемым данным byte-for-byte. XML-код должен оставаться допустимым без лишних символов.

[in] pwzPassword

Указывает пароль, используемый для расшифровки однорангового удостоверения. Пароль должен совпадать с паролем, предоставленным в PeerIdentityExport. Этот параметр не может иметь значение NULL.

[out] ppwzIdentity

Указатель на строку, представляющую импортированное удостоверение однорангового узла. Если операция импорта выполнена успешно, приложение должно освободить ppwzIdentity , вызвав PeerFreeData.

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

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

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

Комментарии

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

<PEERIDENTITYEXPORT VERSION="1.0">
   <IDENTITY>
     <!-- UTF-8 encoded peer name of the identity -->
   </IDENTITY>
   <IDENTITYDATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </IDENTTYDATA>
</PEERIDENTITYEXPORT>

Требования

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

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

PEER_DATA

PeerFreeData

PeerIdentityExport