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

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

  • Статья

Функция PeerIdentityGetXML возвращает описание однорангового удостоверения, которое затем можно передать третьим лицам и использовать для приглашения однорангового удостоверения в одноранговую группу. Эти сведения возвращаются в виде фрагмента XML.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetXML(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzIdentityXML
);

Параметры

[in] pwzIdentity

Указывает удостоверение однорангового узла, для которого нужно получить сведения об идентификаторе однорангового узла. Если этот параметр передается как NULL, одноранговой инфраструктурой для пользователя будет создано удостоверение по умолчанию.

[out] ppwzIdentityXML

Указатель на указатель на строку Юникода, содержащую фрагмент XML. Если ppwzIdentityXML больше не требуется, приложение отвечает за освобождение этой строки путем вызова PeerFreeData.

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

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

Код возврата Описание
E_HANDLE
 Дескриптор удостоверения недопустим.
E_INVALIDARG
 Один из параметров недопустим.
E_OUTOFMEMORY
 Недостаточно памяти для выполнения указанной операции.

Комментарии

Возвращаемый фрагмент XML имеет следующую структуру:

<PEERIDENTITYINFO VERSION="1.0">
     <IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
          Base 64 encoded certificate.
     </IDC>
</PEERIDENTITYINFO>

Этот ФРАГМЕНТ XML используется при создании приглашения на присоединение к группе.

Приложения не могут добавлять теги в тег PEERIDENTITYINFO или изменять этот ФРАГМЕНТ XML каким-либо образом. Приложениям разрешено включать этот ФРАГМЕНТ XML в другие XML-документы, но перед передачей этого фрагмента в PeerGroupCreateInvitation необходимо удалить весь XML-код приложения.

Требования

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

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

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation