PEER_GRAPH_PROPERTIES-Struktur (p2p.h)
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
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 |