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

Статья
08/25/2023

Функция PeerGroupJoin подготавливает одноранговый узел с приглашением присоединиться к существующей группе одноранговых узлов перед вызовом PeerGroupConnect или PeerGroupConnectByAddress.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Параметры

[in] pwzIdentity

Указатель на строку Юникода, содержащую удостоверение, открывающее указанную группу одноранговых узлов. Если этот параметр имеет значение NULL, реализация использует удостоверение, полученное из PeerIdentityGetDefault.

[in] pwzInvitation

Указатель на строку Юникода, содержащую XML-приглашение, предоставленное другим одноранговым элементом. Приглашение создается, когда приглашающий одноранговый узел вызывает PeerGroupCreateInvitation или PeerGroupIssueCredentials. Конкретные сведения об этом приглашении можно получить в виде PEER_INVITATION_INFO структуры, вызвав PeerGroupParseInvitation. Это обязательный параметр.

[in] pwzCloud

Указатель на строку Юникода, содержащую имя облака PNRP, в котором находится группа. Значение по умолчанию — NULL, указывающее, что необходимо использовать облако, указанное в приглашении.

[out] phGroup

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

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

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

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
PEER_E_CLOUD_NAME_AMBIGUOUS	Облако не может быть обнаружено уникальным образом, например, несколько облаков соответствует указанному имени.
PEER_E_INVALID_PEER_NAME	Идентификатор однорангового узла, указанный в pwzIdentity , недопустим.
PEER_E_INVALID_TIME_PERIOD	Срок действия, указанный в приглашении, недопустим. Либо указанный период истек, либо приглашение еще не является действительным (т. е. указанная дата и время действия еще не достигнута). Одна из возможных причин возврата этой ошибки заключается в том, что системные часы неправильно заданы на компьютере, присоединенном к группе, или на компьютере, который выдал приглашение.
PEER_E_INVITATION_NOT_TRUSTED	Приглашение не является доверенным. Это может быть вызвано изменением приглашения, ошибками или истечением срока действия.
PEER_E_NO_CLOUD	Не удается найти облако.
PEER_E_UNSUPPORTED_VERSION	Приглашение не поддерживается текущей версией одноранговой инфраструктуры.
PEER_E_NO_KEY_ACCESS	Доступ к удостоверению однорангового узла или ключам группы одноранговых узлов запрещен. Как правило, это вызвано неправильным списком управления доступом (ACL) для папки, содержащей ключи пользователя или компьютера. Это может произойти при сбросе списка ACL вручную.

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

Требования


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