struttura PEER_GRAPH_PROPERTIES (p2p.h)

Articolo
03/05/2024

La struttura PEER_GRAPH_PROPERTIES contiene dati sui criteri di un grafico peer, un ID, un ambito e altre informazioni.

Sintassi

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;

Members

dwSize

Specifica le dimensioni, in byte, di questa struttura di dati. Il membro dwSize deve essere impostato sulle dimensioni di PEER_GRAPH_PROPERTIES prima di chiamare PeerGraphCreate. Questo membro è obbligatorio. Non esiste un valore predefinito.

dwFlags

Flag che controllano il comportamento di un peer in un grafico. Il valore predefinito non include flag impostati. Il valore valido è identificato nella tabella seguente.

Valore	Descrizione
PEER_GRAPH_PROPERTY_DEFER_EXPIRATION	Specifica quando scadere un record del grafo. Quando un grafico non è connesso e questo flag viene impostato, la scadenza non viene eseguita fino a quando il grafico non si connette ad almeno un altro membro.

dwScope

Specifica l'ambito in cui viene pubblicato l'ID del grafo peer. Il valore predefinito è globale. I valori validi sono identificati nella tabella seguente.

Valore	Descrizione
PEER_GRAPH_SCOPE_GLOBAL	L'ambito include Internet.
PEER_GRAPH_SCOPE_LINK_LOCAL	L'ambito è limitato a una subnet locale.
PEER_GRAPH_SCOPE_SITE_LOCAL	L'ambito è limitato a un sito, ad esempio una intranet aziendale.

dwMaxRecordSize

Specifica il valore che indica il record più grande che può essere aggiunto a un grafico peer. Un valore valido è zero (0), che indica che viene usata la dimensione massima predefinita del record (60 megabyte) e qualsiasi valore compreso tra 1024 byte e 60 megabyte.

pwzGraphId

Specifica l'identificatore univoco per un grafico peer. Questo ID deve essere univoco per la coppia computer/utente. Questo membro è obbligatorio e non ha alcun valore predefinito. Se il valore stringa è maggiore di 256 caratteri (incluso il carattere di terminazione Null), viene restituito un errore.

pwzCreatorId

Specifica l'identificatore univoco per l'autore di un grafo peer. Questo membro è obbligatorio e non ha alcun valore predefinito. Se il valore stringa è maggiore di 256 caratteri (incluso il carattere di terminazione Null), viene restituito un errore.

pwzFriendlyName

Specifica il nome descrittivo di un grafo peer. Questo membro è facoltativo e può essere NULL. Il valore predefinito è NULL. La lunghezza massima di questa stringa è di 256 caratteri, incluso il carattere di terminazione Null.

pwzComment

Specifica il commento utilizzato per descrivere un grafico peer. Questo membro è facoltativo e può essere NULL. Il valore predefinito è NULL. La lunghezza massima di questa stringa è di 512 caratteri, incluso il carattere di terminazione Null.

ulPresenceLifetime

Specifica il numero di secondi prima della scadenza di un record di presenza. Il valore predefinito è 300 secondi (5 minuti). Non impostare il valore di ulPresenceLifetime su meno di 300 secondi. Se questo membro è impostato meno del valore predefinito 300 (5 minuti), può verificarsi un comportamento non definito.

cPresenceMax

Specifica il numero di record di presenza che l'infrastruttura peer mantiene in un grafo peer contemporaneamente. Un nodo con presenza pubblicata può essere enumerato da tutti gli altri nodi con PeerGraphEnumNodes. Specificare la modalità di pubblicazione dei record di presenza per gli utenti specificando uno dei valori identificati nella tabella seguente.

Valore	Descrizione
-1	I record di presenza vengono pubblicati automaticamente per tutti gli utenti.
0	I record di presenza non vengono pubblicati automaticamente.
1-N	Fino a N record di presenza vengono pubblicati contemporaneamente. I record di presenza pubblicati vengono scelti in modo casuale dall'infrastruttura di peer graphing.

Commenti

Un'applicazione può forzare l'infrastruttura peer graphing a pubblicare informazioni sulla presenza usando PeerGraphSetPresence.

È possibile aggiornare solo campi specifici nel PEER_GRAPH_PROPERTIES quando si chiama PeerGraphSetProperties. È possibile aggiornare i membri seguenti:

pwzFriendlyName
pwzComment
ulPresenceLifetime
cPresenceMax

Non è possibile modificare i membri rimanenti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Intestazione	p2p.h

Vedi anche

PeerGraphCreate

PeerGraphGetProperties

PeerGraphSetProperties

Condividi tramite