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

Статья
08/25/2023

Функция PeerGroupOpen открывает группу одноранговых узлов, созданную или присоединенную. После открытия группы одноранговых узлов одноранговый узел может зарегистрироваться для получения уведомлений о событиях.

Синтаксис

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

Параметры

[in] pwzIdentity

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

[in] pwzGroupPeerName

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

[in] pwzCloud

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

[out] phGroup

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

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

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

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

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

Несколько приложений могут одновременно открывать одну и ту же группу. Любое приложение может открыть группу без последующего вызова PeerGroupConnect. Эти приложения считаются автономными. Однако второе приложение может открыть и подключить одноранговый узел к группе, что означает, что приложение должно быть готово к подключению в любое время.

Требования


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

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

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