PEER_GRAPH_PROPERTIES-Struktur (p2p.h)

Artikel
03/01/2024

Die PEER_GRAPH_PROPERTIES-Struktur enthält Daten über die Richtlinie eines Peerdiagramms, die ID, den Bereich und andere Informationen.

Syntax

typedef struct peer_graph_properties_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwScope;
  DWORD dwMaxRecordSize;
  PWSTR pwzGraphId;
  PWSTR pwzCreatorId;
  PWSTR pwzFriendlyName;
  PWSTR pwzComment;
  ULONG ulPresenceLifetime;
  ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;

Member

dwSize

Gibt die Größe dieser Datenstruktur in Bytes an. Das dwSize-Element muss auf die Größe von PEER_GRAPH_PROPERTIES festgelegt werden, bevor PeerGraphCreate aufgerufen wird. Dieser Member ist erforderlich. Es gibt keinen Standardwert.

dwFlags

Flags, die das Verhalten eines Peers in einem Diagramm steuern. Standardmäßig sind keine Flags festgelegt. Der gültige Wert wird in der folgenden Tabelle angegeben.

Wert	BESCHREIBUNG
PEER_GRAPH_PROPERTY_DEFER_EXPIRATION	Gibt an, wann ein Graphdatensatz abläuft. Wenn ein Diagramm nicht verbunden ist und dieses Flag festgelegt ist, erfolgt der Ablauf erst, wenn der Graph eine Verbindung mit mindestens einem anderen Member herstellt.

dwScope

Gibt den Bereich an, in dem die Peerdiagramm-ID veröffentlicht wird. Der Standardwert ist global. Gültige Werte werden in der folgenden Tabelle angegeben.

Wert	BESCHREIBUNG
PEER_GRAPH_SCOPE_GLOBAL	Der Bereich umfasst das Internet.
PEER_GRAPH_SCOPE_LINK_LOCAL	Der Bereich ist auf ein lokales Subnetz beschränkt.
PEER_GRAPH_SCOPE_SITE_LOCAL	Der Bereich ist auf eine Website beschränkt, z. B. ein Unternehmensintranet.

dwMaxRecordSize

Gibt den Wert an, der den größten Datensatz angibt, der einem Peerdiagramm hinzugefügt werden kann. Ein gültiger Wert ist Null (0), was angibt, dass die maximale Standarddatensatzgröße (60 Megabyte) und ein beliebiger Wert zwischen 1024 Bytes und 60 Megabyte verwendet wird.

pwzGraphId

Gibt den eindeutigen Bezeichner für ein Peerdiagramm an. Diese ID muss für das Computer/Benutzer-Paar eindeutig sein. Dieser Member ist erforderlich und hat keinen Standardwert. Wenn der Zeichenfolgenwert größer als 256 Zeichen ist (einschließlich des NULL-Abschlusszeichens), wird ein Fehler zurückgegeben.

pwzCreatorId

Gibt den eindeutigen Bezeichner für den Ersteller eines Peergraphen an. Dieser Member ist erforderlich und hat keinen Standardwert. Wenn der Zeichenfolgenwert größer als 256 Zeichen ist (einschließlich des NULL-Abschlusszeichens), wird ein Fehler zurückgegeben.

pwzFriendlyName

Gibt den Anzeigenamen eines Peerdiagramms an. Dieser Member ist optional und kann NULL sein. Der Standardwert ist NULL. Die maximale Länge dieser Zeichenfolge beträgt 256 Zeichen, einschließlich des NULL-Abschlusszeichens.

pwzComment

Gibt den Kommentar an, der zum Beschreiben eines Peergraphen verwendet wird. Dieser Member ist optional und kann NULL sein. Der Standardwert ist NULL. Die maximale Länge dieser Zeichenfolge beträgt 512 Zeichen, einschließlich des NULL-Abschlusszeichens.

ulPresenceLifetime

Gibt die Anzahl von Sekunden an, bevor ein Anwesenheitsdatensatz abläuft. Der Standardwert ist 300 Sekunden (5 Minuten). Legen Sie den Wert von ulPresenceLifetime nicht auf weniger als 300 Sekunden fest. Wenn dieser Member kleiner als der Standardwert von 300 (5 Minuten) festgelegt ist, kann nicht definiertes Verhalten auftreten.

cPresenceMax

Gibt an, wie viele Anwesenheitsdatensätze die Peerinfrastruktur gleichzeitig in einem Peerdiagramm speichert. Ein Knoten, dessen Anwesenheit veröffentlicht wurde, kann von allen anderen Knoten mit PeerGraphEnumNodes aufgezählt werden. Geben Sie an, wie Anwesenheitsdatensätze für Benutzer veröffentlicht werden, indem Sie einen der in der folgenden Tabelle angegebenen Werte angeben.

Wert	BESCHREIBUNG
-1	Anwesenheitsdatensätze werden automatisch für alle Benutzer veröffentlicht.
0	Anwesenheitsdatensätze werden nicht automatisch veröffentlicht.
1-N	Bis zu N Anzahl von Anwesenheitsdatensätzen werden gleichzeitig veröffentlicht. Die veröffentlichten Anwesenheitsdatensätze werden von der Peer graphing Infrastructure nach dem Zufallsprinzip ausgewählt.

Hinweise

Eine Anwendung kann erzwingen, dass die Peer graphing Infrastructure Mithilfe von PeerGraphSetPresence Anwesenheitsinformationen veröffentlicht.

Nur bestimmte Felder im PEER_GRAPH_PROPERTIES können aktualisiert werden, wenn PeerGraphSetProperties aufgerufen wird. Die folgenden Member können aktualisiert werden:

pwzFriendlyName
pwzComment
ulPresenceLifetime
cPresenceMax

Die übrigen Member können nicht geändert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	p2p.h

Weitere Informationen

PeerGraphErstellen

PeerGraphGetProperties

PeerGraphSetProperties

Freigeben über