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

Функция 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Открыть