структура PEER_GROUP_PROPERTIES (p2p.h)
Структура 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 |