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

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

  • Статья

Функция PeerGroupIssueCredentials выдает учетные данные, включая GMC, определенному удостоверению и при необходимости возвращает СТРОКУ XML приглашения, которая может использовать приглашенный одноранговый узел для присоединения к группе одноранговых узлов.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupIssueCredentials(
  [in]  HGROUP               hGroup,
  [in]  PCWSTR               pwzSubjectIdentity,
  [in]  PEER_CREDENTIAL_INFO *pCredentialInfo,
  [in]  DWORD                dwFlags,
  [out] PWSTR                *ppwzInvitation
);

Параметры

[in] hGroup

Обработка группы одноранговых узлов, для которой одноранговый узел будет выдавать учетные данные потенциальным приглашенным одноранговым узлам. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[in] pwzSubjectIdentity

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

[in] pCredentialInfo

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

Если указан этот параметр, следующие поля в PEER_CREDENTIAL_INFO игнорируются:

  • pwzIssuerPeerName
  • pwzIssuerFriendlyName

[in] dwFlags

Задает набор флагов, используемых для описания действий, выполняемых при выдаче учетных данных. Если для этого параметра задано значение 0 (ноль), учетные данные возвращаются в ppwzInvitation. Этот параметр является необязательным.

Значение Значение
PEER_GROUP_STORE_CREDENTIALS
 Опубликуйте вновь созданный GMC субъекта в базе данных группы. GMC автоматически выбирается субъектом. Если этот флаг не задан, учетные данные должны быть получены другим приложением, например электронной почтой.

[out] ppwzInvitation

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

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

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

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

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Комментарии

Эта функция может быть успешно вызвана только администратором.

Учетные данные для члена (PEER_CREDENTIAL_INFO) получаются путем вызова PeerGroupEnumMembers. Учетные данные находятся в поле pCredentialInfoструктуры PEER_MEMBER для определенного элемента.

Требования

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