PEER_RECORD Struktur (p2p.h)

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 Datensatztyp 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 Peer-Infrastruktur stellt diese ID zur Verfügung. Dieser Parameter wird in Aufrufen von PeerGroupAddRecord ignoriert. Eine Anwendung kann dieses Element nicht ändern.

dwVersion

Gibt die Version eines Datensatzes an, den die Peer-Infrastruktur bereitstellt, wenn eine Anwendung PeerGraphAddRecord oder PeerGraphUpdateRecord aufruft. Eine Anwendung kann dieses Element 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 identifiziert.

Wert Beschreibung
PEER_RECORD_FLAG_AUTOREFRESH Gibt an, dass ein Datensatz automatisch aktualisiert wird, wenn er abläuft.
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 Element ist für Aufrufe von PeerGraphAddRecord und PeerGraphUpdateRecord auf NULL festgelegt. Eine Anwendung kann dieses Element nicht festlegen.

pwzModifiedById

Gibt die eindeutige ID der letzten Person an, die einen Datensatz ändert. Eine Anwendung kann dieses Element nicht festlegen.

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 sie müssen mit dem Attributschema des Peer-Infrastruktur-Datensatzes konsistent sein. Eine vollständige Erläuterung des XML-Schemas finden Sie unter Datensatzattributeschema.

Die Peer-Infrastruktur behält mehrere Attributnamen vor, die ein Benutzer nicht festlegen kann. Die folgende Liste identifiziert die reservierten Attributnamen:

  • peerlastmodifiedby
  • Peercreatorid
  • peerlastmodificationtime
  • Peerrecordid
  • Peerrecordtype
  • Peercreationtime
  • peerlastmodificationtime

ftCreation

Gibt die koordinierte Weltzeit (UTC) an, die ein Datensatz erstellt wird. Die Peer-Infrastruktur stellt diesen Wert bereit, und der Wert wird in Aufrufen von PeerGroupAddRecord auf Null (0) festgelegt. Eine Anwendung kann dieses Element nicht festlegen.

ftExpiration

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

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 dieses Element auf weniger als vier (4) Minuten festgelegt ist, kann das nicht definierte Verhalten auftreten.
 

ftLastModified

Die UTC-Zeit, zu der ein Datensatz geändert wird. Die Peer-Infrastruktur stellt diesen Wert zur Verfügung. Legen Sie dieses Element auf NULL fest, wenn PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord und PeerGroupUpdateRecord aufgerufen werden. Eine Anwendung kann dieses Element nicht festlegen.

securityData

Gibt die In einer PEER_DATA Struktur enthaltenen Sicherheitsdaten an. Die Graphing-API verwendet dieses Mitglied und stellt dem Sicherheitsanbieter einen Ort zum Speichern von Sicherheitsdaten bereit, z. B. eine Signatur. Die Gruppierungs-API kann dieses Element nicht ändern.

data

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP2 [Nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack fürWindows XP
Unterstützte Mindestversion (Server) Nicht unterstützt
Header p2p.h

Weitere Informationen

PEER_DATA

PFNPEER_SECURE_RECORD

PFNPEER_VALIDATE_RECORD

PeerGraphAddRecord

PeerGraphDeleteRecord

PeerGraphGetRecord

PeerGraphUpdateRecord

PeerGroupAddRecord

PeerGroupDeleteRecord

PeerGroupGetRecord

PeerGroupUpdateRecord