структура PEER_GRAPH_PROPERTIES (p2p.h)
Структура PEER_GRAPH_PROPERTIES содержит данные о политике однорангового графа, идентификатора, область и другие сведения.
Синтаксис
typedef struct peer_graph_properties_tag {
DWORD dwSize;
DWORD dwFlags;
DWORD dwScope;
DWORD dwMaxRecordSize;
PWSTR pwzGraphId;
PWSTR pwzCreatorId;
PWSTR pwzFriendlyName;
PWSTR pwzComment;
ULONG ulPresenceLifetime;
ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;
Члены
dwSize
Указывает размер данной структуры данных в байтах. Перед вызовом PeerGraphCreateчлену dwSize необходимо задать размер PEER_GRAPH_PROPERTIES. Этот элемент является обязательным. Значение по умолчанию отсутствует.
dwFlags
Флаги, управляющие поведением однорангового узла в графе. Значение по умолчанию — не имеет установленных флагов. Допустимое значение указано в следующей таблице.
| Значение | Описание |
|---|---|
| PEER_GRAPH_PROPERTY_DEFER_EXPIRATION | Указывает, когда истекает срок действия записи графа. Если граф не подключен и этот флаг установлен, срок действия не наступает до тех пор, пока граф не подключится хотя бы к одному другому элементу. |
dwScope
Указывает область, в котором публикуется идентификатор однорангового графа. Значение по умолчанию — global. Допустимые значения указаны в следующей таблице.
| Значение | Описание |
|---|---|
| PEER_GRAPH_SCOPE_GLOBAL | Область включает Интернет. |
| PEER_GRAPH_SCOPE_LINK_LOCAL | Область ограничена локальной подсетью. |
| PEER_GRAPH_SCOPE_SITE_LOCAL | Область ограничена сайтом, например корпоративной интрасетью. |
dwMaxRecordSize
Задает значение, указывающее самую большую запись, которую можно добавить в одноранговый граф. Допустимое значение равно нулю (0), указывающее, что используется максимальный размер записи по умолчанию (60 мб) и любое значение от 1024 до 60 мегабайт.
pwzGraphId
Указывает уникальный идентификатор однорангового графа. Этот идентификатор должен быть уникальным для пары "компьютер-пользователь". Этот элемент является обязательным и не имеет значения по умолчанию. Если строковое значение превышает 256 символов (включая признак конца null), возвращается ошибка.
pwzCreatorId
Указывает уникальный идентификатор для создателя однорангового графа. Этот элемент является обязательным и не имеет значения по умолчанию. Если строковое значение превышает 256 символов (включая признак конца null), возвращается ошибка.
pwzFriendlyName
Указывает понятное имя однорангового графа. Этот элемент является необязательным и может иметь значение NULL. Значение по умолчанию — NULL. Максимальная длина этой строки составляет 256 символов, включая признак конца null.
pwzComment
Указывает комментарий, используемый для описания однорангового графа. Этот элемент является необязательным и может иметь значение NULL. Значение по умолчанию — NULL. Максимальная длина этой строки составляет 512 символов, включая признак конца null.
ulPresenceLifetime
Указывает количество секунд до истечения срока действия записи о присутствии. Значение по умолчанию — 300 секунд (5 минут). Не устанавливайте значение ulPresenceLifetime менее 300 секунд. Если значение этого элемента меньше 300 (5 минут) по умолчанию, может возникнуть неопределенное поведение.
cPresenceMax
Указывает, сколько записей о присутствии инфраструктура однорангового узла хранит в одноранговом графе за один раз. Узел с опубликованным присутствием может быть перечислен всеми остальными узлами с peerGraphEnumNodes. Укажите способ публикации записей о присутствии для пользователей, указав одно из значений, указанных в следующей таблице.
| Значение | Описание |
|---|---|
| -1 | Записи о присутствии автоматически публикуются для всех пользователей. |
| 0 | Записи о присутствии не публикуются автоматически. |
| 1-N | Одновременно публикуется до N записей о присутствии. Публикуемые записи о присутствии случайным образом выбираются инфраструктурой однорангового графирования. |
Комментарии
Приложение может заставить инфраструктуру одноранговых графов публиковать сведения о присутствии с помощью PeerGraphSetPresence.
При вызове PeerGraphSetProperties можно обновлять только определенные поля в PEER_GRAPH_PROPERTIES. Можно обновить следующие элементы:
- pwzFriendlyName
- pwzComment
- ulPresenceLifetime
- cPresenceMax
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Верхняя часть | p2p.h |