structure PEER_GRAPH_PROPERTIES (p2p.h)

Article
03/01/2024

La structure PEER_GRAPH_PROPERTIES contient des données sur la stratégie d’un graphe homologue, l’ID, l’étendue et d’autres informations.

Syntaxe

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;

Membres

dwSize

Spécifie la taille, en octets, de cette structure de données. Le membre dwSize doit être défini sur la taille de PEER_GRAPH_PROPERTIES avant d’appeler PeerGraphCreate. Ce membre est obligatoire. Il n’existe pas de valeur par défaut.

dwFlags

Indicateurs qui contrôlent le comportement d’un homologue dans un graphique. La valeur par défaut est n’a pas d’indicateurs définis. La valeur valide est identifiée dans le tableau suivant.

Valeur	Description
PEER_GRAPH_PROPERTY_DEFER_EXPIRATION	Spécifie quand expirer un enregistrement de graphique. Lorsqu’un graphe n’est pas connecté et que cet indicateur est défini, l’expiration ne se produit pas tant que le graphique ne se connecte pas à au moins un autre membre.

dwScope

Spécifie l’étendue dans laquelle l’ID de graphe d’homologue est publié. La valeur par défaut est globale. Les valeurs valides sont identifiées dans le tableau suivant.

Valeur	Description
PEER_GRAPH_SCOPE_GLOBAL	L’étendue inclut Internet.
PEER_GRAPH_SCOPE_LINK_LOCAL	L’étendue est limitée à un sous-réseau local.
PEER_GRAPH_SCOPE_SITE_LOCAL	L’étendue est limitée à un site, par exemple un intranet d’entreprise.

dwMaxRecordSize

Spécifie la valeur qui indique le plus grand enregistrement pouvant être ajouté à un graphique homologue. Une valeur valide est zéro (0), ce qui indique que la taille maximale d’enregistrement par défaut est utilisée (60 mégaoctets) et toute valeur comprise entre 1 024 octets et 60 mégaoctets.

pwzGraphId

Spécifie l’identificateur unique d’un graphe d’homologue. Cet ID doit être unique pour la paire ordinateur/utilisateur. Ce membre est obligatoire et n’a aucune valeur par défaut. Si la valeur de la chaîne est supérieure à 256 caractères (y compris la fin null), une erreur est retournée.

pwzCreatorId

Spécifie l’identificateur unique du créateur d’un graphe homologue. Ce membre est obligatoire et n’a aucune valeur par défaut. Si la valeur de la chaîne est supérieure à 256 caractères (y compris la fin null), une erreur est retournée.

pwzFriendlyName

Spécifie le nom convivial d’un graphe homologue. Ce membre est facultatif et peut avoir la valeur NULL. La valeur par défaut est NULL. La longueur maximale de cette chaîne est de 256 caractères, y compris la fin null.

pwzComment

Spécifie le commentaire utilisé pour décrire un graphe d’homologue. Ce membre est facultatif et peut avoir la valeur NULL. La valeur par défaut est NULL. La longueur maximale de cette chaîne est de 512 caractères, y compris la fin null.

ulPresenceLifetime

Spécifie le nombre de secondes avant l’expiration d’un enregistrement de présence. La valeur par défaut est de 300 secondes (5 minutes). Ne définissez pas la valeur de ulPresenceLifetime sur moins de 300 secondes. Si ce membre est défini comme étant inférieur à la valeur par défaut de 300 (5 minutes), un comportement non défini peut se produire.

cPresenceMax

Spécifie le nombre d’enregistrements de présence que l’infrastructure d’homologue conserve dans un graphique homologue à la fois. Un nœud dont la présence est publiée peut être énuméré par tous les autres nœuds avec PeerGraphEnumNodes. Spécifiez la façon dont les enregistrements de présence pour les utilisateurs sont publiés en spécifiant l’une des valeurs identifiées dans le tableau suivant.

Valeur	Description
-1	Les enregistrements de présence sont automatiquement publiés pour tous les utilisateurs.
0	Les enregistrements de présence ne sont pas publiés automatiquement.
1-N	Jusqu’à N nombre d’enregistrements de présence sont publiés à la fois. Les enregistrements de présence publiés sont choisis de manière aléatoire par l’infrastructure peer graphing.

Remarques

Une application peut forcer l’infrastructure Peer Graphing à publier des informations de présence à l’aide de PeerGraphSetPresence.

Seuls les champs spécifiques du PEER_GRAPH_PROPERTIES peuvent être mis à jour lors de l’appel de PeerGraphSetProperties. Les membres suivants peuvent être mis à jour :

pwzFriendlyName
pwzComment
ulPresenceLifetime
cPresenceMax

Les membres restants ne peuvent pas être modifiés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge	Aucun pris en charge
En-tête	p2p.h

Voir aussi

PeerGraphCreate

PeerGraphGetProperties

PeerGraphSetProperties

Partager via