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

Статья
08/25/2023

Структура PEER_RECORD содержит объект записи, который использует приложение.

Синтаксис

typedef struct peer_record_tag {
  DWORD     dwSize;
  GUID      type;
  GUID      id;
  DWORD     dwVersion;
  DWORD     dwFlags;
  PWSTR     pwzCreatorId;
  PWSTR     pwzModifiedById;
  PWSTR     pwzAttributes;
  FILETIME  ftCreation;
  FILETIME  ftExpiration;
  FILETIME  ftLastModified;
  PEER_DATA securityData;
  PEER_DATA data;
} PEER_RECORD, *PPEER_RECORD;

Члены

dwSize

Указывает размер структуры. Задайте значение sizeof(PEER_RECORD).

type

Указывает тип записи. Типом является GUID , который должен указать приложение. GUID представляет уникальный тип записи, например запись чата.

id

Указывает уникальный идентификатор записи. Одноранговая инфраструктура предоставляет этот идентификатор. Этот параметр игнорируется в вызовах PeerGroupAddRecord. Приложение не может изменить этот элемент.

dwVersion

Указывает версию записи, которую предоставляет одноранговая инфраструктура, когда приложение вызывает PeerGraphAddRecord или PeerGraphUpdateRecord. Приложение не может изменить этот элемент.

dwFlags

Указывает флаги, указывающие на специальную обработку, которая должна применяться к записи. В следующей таблице указаны допустимые значения.

Значение	Описание
PEER_RECORD_FLAG_AUTOREFRESH	Указывает, что запись автоматически обновляется, когда срок ее действия будет готов к истечению срока действия.
PEER_RECORD_FLAG_DELETED	Указывает, что запись помечена как удаленная.

Примечание Приложение не может задать эти флаги.

pwzCreatorId

Указатель на уникальный идентификатор создателя записей. Для этого элемента задано значение NULL для вызовов PeerGraphAddRecord и PeerGraphUpdateRecord. Приложение не может задать этот элемент.

pwzModifiedById

Указывает уникальный идентификатор последнего человека, который изменяет запись. Приложение не может задать этот элемент.

pwzAttributes

Указатель на набор пар имен атрибутов и значений, связанных с записью. Этот элемент указывает на XML-строку. Атрибуты записей указываются в виде строки XML и должны соответствовать схеме атрибутов записи инфраструктуры одноранговых узлов. Полное описание схемы XML см. в разделе Record Attribute Schema.

Одноранговая инфраструктура резервирует несколько имен атрибутов, которые пользователь не может задать. В следующем списке указаны имена зарезервированных атрибутов:

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

Указывает время в формате UTC, в котором создается запись. Одноранговая инфраструктура предоставляет это значение, а в вызовах PeerGroupAddRecord оно равно нулю (0). Приложение не может задать этот элемент.

ftExpiration

Время в формате UTC, в течение которого истекает срок действия записи. Этот член является обязательным. Его можно обновить до значения времени, превышающего первоначально указанное значение времени, но оно не может быть меньше первоначально указанного значения.

Примечание Если параметр dwFlags имеет значение PEER_RECORD_FLAG_AUTOREFRESH, не устанавливайте значение ftExpiration менее четырех (4) минут. Если для этого элемента задано значение менее четырех (4) минут, может возникнуть неопределенное поведение.

ftLastModified

Время изменения записи в формате UTC. Одноранговая инфраструктура предоставляет это значение. Установите для этого элемента значение NULL при вызове PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord и PeerGroupUpdateRecord. Приложение не может задать этот элемент.

securityData

Указывает данные безопасности, содержащиеся в структуре PEER_DATA . API graphing использует этот элемент и предоставляет поставщику безопасности место для хранения данных безопасности, например сигнатуры. API группирования не может изменить этот элемент.

data

Указывает фактические данные, содержащиеся в этой записи.

Требования

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