структура PEER_GROUP_PROPERTIES (p2p.h)

Статья
08/25/2023

Структура PEER_GROUP_PROPERTIES содержит данные о политике членства в одноранговой группе.

Синтаксис

typedef struct peer_group_properties_tag {
  DWORD        dwSize;
  DWORD        dwFlags;
  PWSTR        pwzCloud;
  PWSTR        pwzClassifier;
  PWSTR        pwzGroupPeerName;
  PWSTR        pwzCreatorPeerName;
  PWSTR        pwzFriendlyName;
  PWSTR        pwzComment;
  ULONG        ulMemberDataLifetime;
  ULONG        ulPresenceLifetime;
  DWORD        dwAuthenticationSchemes;
  PWSTR        pwzGroupPassword;
  PEER_ROLE_ID groupPasswordRole;
} PEER_GROUP_PROPERTIES, *PPEER_GROUP_PROPERTIES;

Члены

dwSize

Размер структуры в байтах.

dwFlags

PEER_GROUP_PROPERTY_FLAGS флаги, описывающие поведение одноранговой группы. Значение по умолчанию равно нулю (0), что означает, что флаги не заданы.

pwzCloud

Указывает имя облака PNRP, в котором участвует группа одноранговых узлов. Значение по умолчанию — global, если этот элемент имеет значение NULL.

pwzClassifier

Задает классификатор, используемый для идентификации имени одноранговой группы одноранговых узлов для регистрации или разрешения в облаке PNRP. Максимальный размер этого поля — 149 символов Юникода. Этот элемент может иметь значение NULL.

pwzGroupPeerName

Указывает имя одноранговой группы, зарегистрированной в службе PNRP. Максимальный размер этого поля — 137 символов Юникода.

pwzCreatorPeerName

Указывает имя однорангового узла, связанного с создателем группы одноранговых узлов. Максимальный размер этого поля — 137 символов Юникода. Если этот элемент структуры имеет значение NULL, реализация использует удостоверение, полученное из PeerIdentityGetDefault.

pwzFriendlyName

Указывает понятное (отображаемое) имя одноранговой группы. Максимальный размер этого поля — 255 символов.

pwzComment

Содержит комментарий, используемый для описания одноранговой группы. Максимальный размер этого поля — 255 символов.

ulMemberDataLifetime

Указывает время существования (в секундах) данных членов одноранговой группы (PEER_MEMBER). Минимальное значение для этого поля — 8 часов, а максимальное — 10 лет. Значение по умолчанию — 2 419 200 секунд или 28 дней.

Если это значение равно нулю (0), данные элемента имеют максимально допустимое время существования, то есть время, оставшееся в течение времени существования администратора, который выдает учетные данные для члена.

ulPresenceLifetime

Указывает время существования (в секундах) сведений о присутствии, опубликованных в одноранговой группе. Значение по умолчанию — 300 секунд. Не устанавливайте значение ulPresenceLifetime менее 300 секунд. Если для этого элемента задано значение меньше 300-секундного значения по умолчанию, может возникнуть неопределенное поведение.

dwAuthenticationSchemes

Windows Vista или более поздней версии. Логическое ИЛИ PEER_GROUP_AUTHENTICATION_SCHEME значения перечисления, указывающие типы проверки подлинности, поддерживаемые одноранговой группой.

pwzGroupPassword

Windows Vista или более поздней версии. Указатель на строку Юникода, содержащую пароль, используемый для проверки подлинности одноранговых узлов, пытающихся присоединиться к группе одноранговых узлов.

groupPasswordRole

Windows Vista или более поздней версии. Значение GUID, указывающее роль группы одноранговых узлов, для которой требуется пароль для проверки подлинности.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Ни одна версия не поддерживается
Верхняя часть	p2p.h

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

PeerGroupCreate

PeerGroupGetProperties

Свойства PeerGroupSet

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