PeerGraphAddRecord, fonction (p2p.h)

  • Article

La fonction PeerGraphAddRecord ajoute un nouvel enregistrement à un graphique homologue. Un enregistrement ajouté avec cette fonction est envoyé à chaque nœud dans un graphique homologue.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Paramètres

[in] hGraph

Gérer vers un graphe d’homologue.

[in] pRecord

Pointeur vers un enregistrement à ajouter.

[out] pRecordId

Spécifie l’ID d’enregistrement qui identifie de manière unique un enregistrement dans un graphique homologue.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour Description
E_ACCESSDENIED
 Impossible d’accéder à un graphique homologue.
E_INVALIDARG
 L’un des paramètres n’est pas valide.
E_OUTOFMEMORY
 La mémoire est insuffisante pour effectuer une opération spécifiée.
PEER_E_GRAPH_NOT_READY
 Un graphique n’est pas synchronisé. Les enregistrements ne peuvent pas être ajoutés tant que le graphe homologue n’est pas synchronisé.
PEER_E_GRAPH_SHUTTING_DOWN

PeerGraphClose a été appelé.
PEER_E_INVALID_ATTRIBUTES
 Les attributs spécifiés ne correspondent pas au schéma.
PEER_E_INVALID_GRAPH
 Le handle d’un graphe d’homologue n’est pas valide.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 L’enregistrement dépasse la taille maximale autorisée par un graphe homologue.
PEER_E_NOT_INITIALIZED
 Le graphe doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Les membres suivants de la structure PEER_RECORD doivent contenir des valeurs valides :

  • dwSize.
  • type.
  • ftExpiration : doit être postérieure à l’heure actuelle du graphique et doit être spécifiée dans l’heure d’homologue à l’aide de PeerGraphUniversalTimeToPeerTime.
Les membres suivants de la structure PEER_RECORD sont facultatifs. Définissez-les sur NULL s’ils ne sont pas utilisés par votre application :
  • data
  • pwzAttributes
  • securityData
  • dwVersion
Si l’un des membres suivants a la valeur NULL, l’API Peer Graphing exécute le comportement par défaut spécifié : Les membres suivants ne peuvent pas être spécifiés ; toute valeur utilisée est remplacée par l’infrastructure Peer Graphing :
  • id.
  • ftCreation : utilise l’heure d’homologue.
  • ftLastModified : utilise l’heure d’homologue.

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
Plateforme cible Windows
En-tête p2p.h
Bibliothèque P2PGraph.lib
DLL P2PGraph.dll

Voir aussi

PEER_RECORD

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate