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