Функция PeerGroupOpen (p2p.h)
Функция 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 , если операция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Один из параметров недопустим. |
|
Недостаточно памяти для завершения операции. |
|
Облако, указанное в pwzCloud , не может быть обнаружено уникальным образом, например, несколько облаков соответствуют указанному имени. |
|
Не удается найти облако, указанное в pwzCloud . |
|
Доступ к удостоверению однорангового узла или ключам группы одноранговых узлов запрещен. Как правило, это вызвано неправильным списком управления доступом (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 |