PEER_RECORD-Struktur (p2p.h)

Artikel
08/25/2023

Die PEER_RECORD-Struktur enthält das Datensatzobjekt, das eine Anwendung verwendet.

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;

Member

dwSize

Gibt die Größe einer Struktur an. Legen Sie den Wert auf sizeof(PEER_RECORD) fest.

type

Gibt den Typ des Datensatzes an. Der Typ ist eine GUID , die eine Anwendung angeben muss. Die GUID stellt einen eindeutigen Datensatztyp dar, z. B. einen Chatdatensatz.

id

Gibt die eindeutige ID eines Datensatzes an. Die Peerinfrastruktur stellt diese ID bereit. Dieser Parameter wird in Aufrufen von PeerGroupAddRecord ignoriert. Eine Anwendung kann diesen Member nicht ändern.

dwVersion

Gibt die Version eines Datensatzes an, den die Peerinfrastruktur bereitstellt, wenn eine Anwendung PeerGraphAddRecord oder PeerGraphUpdateRecord aufruft. Eine Anwendung kann diesen Member nicht ändern.

dwFlags

Gibt die Flags an, die eine spezielle Verarbeitung angeben, die auf einen Datensatz angewendet werden muss. In der folgenden Tabelle werden die gültigen Werte angegeben.

Wert	BESCHREIBUNG
PEER_RECORD_FLAG_AUTOREFRESH	Gibt an, dass ein Datensatz automatisch aktualisiert wird, wenn er zum Ablauf bereit ist.
PEER_RECORD_FLAG_DELETED	Gibt an, dass ein Datensatz als gelöscht markiert ist.

Hinweis Eine Anwendung kann diese Flags nicht festlegen.

pwzCreatorId

Zeiger auf die eindeutige ID eines Datensatzerstellers. Dieses Member ist für Aufrufe von PeerGraphAddRecord und PeerGraphUpdateRecord auf NULL festgelegt. Dieses Element kann von einer Anwendung nicht festgelegt werden.

pwzModifiedById

Gibt die eindeutige ID der letzten Person an, die einen Datensatz ändert. Dieses Element kann von einer Anwendung nicht festgelegt werden.

pwzAttributes

Zeiger auf den Satz von Attributnamen- und Wertpaaren, die einem Datensatz zugeordnet sind. Dieses Element verweist auf eine XML-Zeichenfolge. Datensatzattribute werden als XML-Zeichenfolge angegeben und müssen mit dem Attributschema für Peerinfrastrukturdatensatz konsistent sein. Eine vollständige Erklärung des XML-Schemas finden Sie unter Datensatzattributeschema.

Die Peerinfrastruktur reserviert mehrere Attributnamen, die ein Benutzer nicht festlegen kann. In der folgenden Liste werden die reservierten Attributnamen identifiziert:

peerlastmodifiedby
peercreatorid
peerlastmodification
peerrecordid
peerrecordtype
peercreationtime
peerlastmodification

ftCreation

Gibt die koordinierte Weltzeit (UTC) an, die ein Datensatz erstellt wird. Die Peerinfrastruktur stellt diesen Wert bereit, und der Wert wird in Aufrufen von PeerGroupAddRecord auf Null (0) festgelegt. Dieses Element kann von einer Anwendung nicht festgelegt werden.

ftExpiration

Die UTC-Zeit, zu der ein Datensatz abläuft. Dieses Element ist erforderlich. Er kann auf einen Zeitwert aktualisiert werden, der größer als der ursprünglich angegebene Zeitwert ist, darf aber nicht kleiner als der ursprünglich angegebene Wert sein.

Hinweis Wenn dwFlags auf PEER_RECORD_FLAG_AUTOREFRESH festgelegt ist, legen Sie den Wert von ftExpiration nicht auf weniger als vier (4) Minuten fest. Wenn dieser Member auf weniger als vier (4) Minuten festgelegt ist, kann nicht definiertes Verhalten auftreten.

ftLastModified

Die UTC-Zeit, zu der ein Datensatz geändert wird. Die Peerinfrastruktur stellt diesen Wert bereit. Legen Sie dieses Element beim Aufrufen von PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord und PeerGroupUpdateRecord aufNULL fest. Dieses Element kann von einer Anwendung nicht festgelegt werden.

securityData

Gibt die Sicherheitsdaten an, die in einer PEER_DATA-Struktur enthalten sind. Die Graphing-API verwendet dieses Element und stellt dem Sicherheitsanbieter einen Ort zum Speichern von Sicherheitsdaten bereit, z. B. eine Signatur. Dieses Element kann von der Gruppierungs-API nicht geändert werden.

data

Gibt die tatsächlichen Daten an, die dieser Datensatz enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	p2p.h