PEER_RECORD structure (p2p.h)

Article
10/05/2021

The PEER_RECORD structure contains the record object that an application uses.

Syntax

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;

Members

dwSize

Specifies the size of a structure. Set the value to sizeof(PEER_RECORD).

type

Specifies the type of record. The type is a GUID that an application must specify. The GUID represents a unique record type, for example, a chat record.

id

Specifies the unique ID of a record. The Peer Infrastructure supplies this ID. This parameter is ignored in calls to PeerGroupAddRecord. An application cannot modify this member.

dwVersion

Specifies the version of a record that the Peer Infrastructure supplies when an application calls PeerGraphAddRecord or PeerGraphUpdateRecord. An application cannot modify this member.

dwFlags

Specifies the flags that indicate special processing, which must be applied to a record. The following table identifies the valid values.

Value	Description
PEER_RECORD_FLAG_AUTOREFRESH	Indicates that a record is automatically refreshed when it is ready to expire.
PEER_RECORD_FLAG_DELETED	Indicates that a record is marked as deleted.

Note An application cannot set these flags.

pwzCreatorId

Pointer to the unique ID of a record creator. This member is set to NULL for calls to PeerGraphAddRecord and PeerGraphUpdateRecord. An application cannot set this member.

pwzModifiedById

Specifies the unique ID of the last person who changes a record. An application cannot set this member.

pwzAttributes

Pointer to the set of attribute name and value pairs that are associated with a record. This member points to an XML string. Record attributes are specified as an XML string, and they must be consistent with the Peer Infrastructure record attribute schema. For a complete explanation of the XML schema, see Record Attribute Schema.

The Peer Infrastructure reserves several attribute names that a user cannot set. The following list identifies the reserved attribute names:

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

Specifies the Coordinated Universal Time (UTC) that a record is created. The Peer Infrastructure supplies this value, and the value is set to zero (0) in calls to PeerGroupAddRecord. An application cannot set this member.

ftExpiration

The UTC time that a record expires. This member is required. It can be updated to a time value greater than the originally specified time value, but it cannot be less than the originally specified value.

Note If dwFlags is set to PEER_RECORD_FLAG_AUTOREFRESH, do not set the value of ftExpiration to less than four (4) minutes. If this member is set to less than four (4) minutes, undefined behavior can occur.

ftLastModified

The UTC time that a record is modified. The Peer Infrastructure supplies this value. Set this member to NULL when calling PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord, and PeerGroupUpdateRecord. An application cannot set this member.

securityData

Specifies the security data contained in a PEER_DATA structure. The Graphing API uses this member, and provides the security provider with a place to store security data, for example, a signature. The Grouping API cannot modify this member.

data

Specifies the actual data that this record contains.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack forWindows XP
Minimum supported server	None supported
Header	p2p.h

PEER_RECORD structure (p2p.h)

Syntax

Members

Requirements

See also

Feedback

Feedback

Additional resources