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

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

  • Статья

Функция PeerGroupSetProperties задает текущие свойства группы одноранговых узлов. В версии 1.0 этого API эту операцию может выполнять только создатель одноранговой группы.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
  [in] HGROUP                 hGroup,
  [in] PPEER_GROUP_PROPERTIES pProperties
);

Параметры

[in] hGroup

Обработка одноранговой группы, свойства которой задаются одноранговым элементом. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[in] pProperties

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

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

  • dwSize
  • pwzCloud
  • pwzClassifier
  • pwzGroupPeerName
  • pwzCreatorPeerName

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

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

Код возврата Описание
E_OUTOFMEMORY
 Недостаточно памяти для завершения операции.
PEER_E_GROUP_NOT_READY
 Группа не находится в состоянии, в котором можно задать свойства одноранговой группы. Например, была вызвана функция PeerGroupJoin , но синхронизация с базой данных группы одноранговых узлов не завершена.
PEER_E_INVALID_GROUP
 Дескриптор одноранговой группы недопустим.
PEER_E_INVALID_GROUP_PROPERTIES
 Одно или несколько указанных свойств являются недопустимыми.
PEER_E_NOT_AUTHORIZED
 Текущее удостоверение не имеет разрешения на изменение этих свойств. В этом случае удостоверение не является создателем группы одноранговых узлов.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY
 Указанный пароль не соответствует требованиям к системным паролям.
 

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

Комментарии

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

Требования

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

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

PEER_GROUP_PROPERTIES

PeerGroupCreate

PeerGroupGetProperties

PeerGroupJoin

PeerGroupOpen