Utilisation de graphes

Lorsque vous utilisez des graphiques homologues, les fonctions doivent être appelées dans un ordre spécifique. Le flux d’appels dépend de la création ou de l’ouverture d’un graphique homologue. Cette rubrique identifie le flux d’appels de fonction dans une application de graphique d’homologue simple.

Démarrage d’un graphique

Avant qu’une application appelle une fonction dans l’API Peer Graphing, PeerGraphStartup doit être appelé pour initialiser l’API Peer Graphing pour une application, puis définir la version prise en charge.

Création d’un graphe homologue

La procédure suivante identifie le flux d’appels pour la création d’un graphique homologue.

Important

Un seul homologue doit appeler PeerGraphCreate. Tous les autres homologues doivent appeler PeerGraphOpen. Plusieurs appels à PeerGraphCreate invalident un graphique.

 

• Créez un graphique homologue. Appelez PeerGraphCreate.

• Inscrivez-vous aux événements d’homologue. Appelez PeerGraphRegisterEvent.

  Notes

  Pour plus d’informations sur l’inscription aux événements homologues, consultez Infrastructure des événements.

   

• Écoutez les connexions à un graphique homologue. Appelez PeerGraphListen.

• Exécutez des fonctions dépendantes de l’application pendant le reste de la durée d’exécution, par exemple, traitez les événements d’homologue et travaillez avec des connexions.

• Fermez la connexion à un graphe homologue. Appelez PeerGraphClose.

Ouverture d’un graphe homologue

Le flux d’appels de fonction pour ouvrir un graphique homologue dépend de la valeur de retour de l’appel à PeerGraphOpen. Les valeurs les plus importantes sont S_OK et PEER_S_DATA_CREATED, qui sont expliquées dans les sections suivantes de cette rubrique.

Notes

Si un appel à PeerGraphOpen ne retourne pas S_OK ou PEER_S_DATA_CREATED, gérez l’erreur.

 

Quand PeerGraphOpen retourne S_OK

Lorsqu’un appel à PeerGraphOpen retourne S_OK, un graphique homologue et une base de données existante ont été ouverts. La procédure suivante identifie ce que vous pouvez faire pour ouvrir un graphique d’homologue lorsqu’un appel à PeerGraphOpen retourne S_OK

• Inscrivez-vous aux événements d’homologue. Appelez PeerGraphRegisterEvent.

  Notes

  Pour plus d’informations sur l’inscription aux événements, consultez Infrastructure des événements.

   

• Recherchez un nœud. Il s’agit d’un processus effectué en dehors de l’infrastructure de graphes homologues, à l’aide d’une méthode ou d’une application que vous identifiez. L’API Peer Graphing ne fournit pas de mécanisme spécifique pour trouver un nœud de graphe initial auquel se connecter. Une application doit utiliser un autre mécanisme, tel que l’API PNRP (Peer Name Resolution Protocol), pour localiser le nœud initial.

• Si un nœud est trouvé, connectez-vous à celui-ci. Appelez PeerGraphConnect, puis appelez PeerGraphListen pour écouter les connexions au graphe homologue.

  Notes

  Si un nœud est introuvable, n’appelez pas PeerGraphConnect et PeerGraphListen.

   

• Effectuez des fonctions dépendantes de l’application pendant le reste de la durée d’exécution, par exemple, traitez les événements d’homologue et utilisez des connexions, selon que le nœud est connecté ou non au graphique homologue. Par exemple, l’application peut choisir d’expirer ou d’effectuer régulièrement la découverte d’un nœud actif dans le graphique.

• Fermez la connexion au graphe homologue. Appelez PeerGraphClose.

Quand PeerGraphOpen retourne PEER_S_DATA_CREATED

Lorsque PeerGraphOpen retourne PEER_S_DATA_CREATED, cela signifie qu’une base de données existante pour un graphique homologue est introuvable, qu’une base de données est créée et que c’est la première fois qu’elle est ouverte. Pour utiliser ou écouter sur un graphique d’homologue, un homologue doit être connecté à un graphique homologue et synchronisé avec ce graphique.

La procédure suivante identifie ce que vous pouvez faire pour ouvrir un graphique d’homologue lorsqu’un appel à PeerGraphOpen retourne PEER_S_DATA_CREATED.

• Ouvrez un graphique homologue. Appelez PeerGraphOpen.

• Inscrivez-vous aux événements d’homologue. Appelez PeerGraphRegisterEvent.

  Notes

  Pour plus d’informations sur l’inscription aux événements homologues, consultez Infrastructure des événements.

   

• Recherchez un nœud. Il s’agit d’un processus effectué en dehors de l’infrastructure de graphes homologues, à l’aide d’une méthode ou d’une application que vous identifiez. L’API Peer Graphing ne fournit pas de mécanisme spécifique pour trouver un nœud de graphe initial auquel se connecter. Une application doit utiliser un autre mécanisme, tel que l’API PNRP (Peer Name Resolution Protocol), pour localiser le nœud initial.

• Si un nœud est trouvé, connectez-vous à celui-ci. Appelez PeerGraphConnect, puis appelez PeerGraphListen pour écouter les connexions au graphe homologue.

  Notes

  Si un nœud est introuvable, n’appelez pas PeerGraphConnect et PeerGraphListen.

   

• Effectuez des fonctions dépendantes de l’application pendant le reste de la durée d’exécution, par exemple, traitez les événements d’homologue et utilisez des connexions, selon que le nœud est connecté ou non au graphique homologue. Par exemple, l’application peut choisir d’expirer ou d’effectuer régulièrement la découverte d’un nœud actif dans le graphique.

• Fermez la connexion au graphe homologue. Appelez PeerGraphClose.