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

Статья
03/01/2024

Функция PeerGroupCreate создает новую группу одноранговых узлов.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

Параметры

[in] pProperties

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

Необходимо задать следующие элементы:

pwzCreatorPeerName

Невозможно задать следующие элементы:

pwzGroupPeerName

Остальные члены являются необязательными.

[out] phGroup

Возвращает указатель дескриптора на одноранговую группу. Любая функция, вызываемая с этим дескриптором в качестве параметра, имеет соответствующее действие, выполняемое в этой группе одноранговых узлов. Это обязательный параметр.

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

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

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

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

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

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

Для приложений, использующих пароли, рекомендуется безопасно обрабатывать пароли путем вызова функций CryptoProtectMemory и SecureZeroMemory .

Требования

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

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

PEER_GROUP_PROPERTIES

PeerGroupClose

PeerGroupConnect

PeerGroupОткрыть

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