структура PEER_RECORD (p2p.h)
Структура 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, в течение которого истекает срок действия записи. Этот член является обязательным. Его можно обновить до значения времени, превышающего первоначально указанное значение времени, но оно не может быть меньше первоначально указанного значения.
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 |