Fonctions de l’API Graphing

Article
03/13/2025

L’API Peer Graphing utilise les fonctions suivantes :

Fonctions d’initialisation et de nettoyage

Fonction	Description
PeerGraphShutdown	Nettoie toutes les ressources allouées par l’appel à PeerGraphStartup.
PeerGraphStartup	Indique à l’infrastructure Peer Graphing quelle version des protocoles homologues l’application appelante requiert.

Fonctions de création et d’accès au graphe

Fonction	Description
peerGraphClose	Invalide le handle de graphique homologue retourné par un appel à PeerGraphCreate ou PeerGraphOpen, et ferme toutes les connexions réseau pour le graphique homologue spécifié.
peerGraphCreate	Crée un graphe homologue.
peerGraphDelete	Supprime les données associées à un graphique homologue spécifié.
PeerGraphListen	Indique qu’un graphique homologue doit commencer à écouter les connexions entrantes.
peerGraphOpen	Ouvre un graphique homologue créé précédemment par le nœud local ou un nœud distant.

Fonctions d’informations sur les graphiques et les nœuds

Fonction	Description
PeerGraphEnumNodes	Crée et retourne un handle d’énumération utilisé pour énumérer les nœuds dans un graphique homologue.
peerGraphGetNodeInfo	Récupère des informations sur un nœud spécifique.
PeerGraphGetProperties	Récupère les propriétés actuelles du graphe homologue.
peerGraphGetStatus	Retourne l’état actuel du graphique homologue.
PeerGraphSetNodeAttributes	Définit les attributs de la structure PEER_NODE_INFO pour le nœud local.
PeerGraphSetPresence	Active ou désactive explicitement la publication d’enregistrements de présence pour un nœud spécifique. Cette fonction peut remplacer les paramètres de présence dans les propriétés du graphique homologue.
PeerGraphSetProperties	Définit les propriétés du graphique homologue.

Fonctions de gestion des enregistrements

Fonction	Description
PeerGraphAddRecord	Ajoute un nouvel enregistrement à un graphique homologue. Un enregistrement ajouté avec cette fonction est envoyé à chaque nœud d’un graphique homologue.
PeerGraphDeleteRecord	Marque un enregistrement comme supprimé dans un graphique homologue.
PeerGraphEnumRecords	Crée et retourne un handle d’énumération utilisé pour énumérer les enregistrements d’un type spécifique d’enregistrement, d’utilisateur ou les deux.
peerGraphGetRecord	Récupère un enregistrement spécifique en fonction de l’ID d’enregistrement spécifié.
PeerGraphSearchRecords	Recherche dans le graphique homologue des enregistrements spécifiques.
peerGraphUpdateRecord	Met à jour un enregistrement dans le graphique homologue, puis inonde l’enregistrement sur chaque nœud du graphique homologue.
PeerGraphValidateDeferredRecords	Indique à l’infrastructure peer Graphing qu’il est temps de soumettre à nouveau tous les enregistrements différés du module de sécurité à valider.

Exporter et importer des fonctions

Fonction	Description
peerGraphExportDatabase	Exporte une base de données de graphe homologue dans un fichier que vous pouvez déplacer vers un autre ordinateur.
PeerGraphImportDatabase	Importe un fichier qui contient les informations d’une base de données de graphe homologue.

Fonctions utilitaires et de support

Fonction	Description
peerGraphEndEnumeration	Libère un handle d’énumération et libère les ressources associées à une énumération.
PeerGraphFreeData	Libère les ressources retournées par plusieurs fonctions de l’API Peer Graphing.
PeerGraphGetItemCount	Récupère le nombre d’éléments d’une énumération.
PeerGraphGetNextItem	Obtient l’élément ou les éléments suivants dans une énumération créée par un appel à des fonctions spécifiques, qui retournent une énumération homologue.
PeerGraphPeerTimeToUniversalTime	Convertit la valeur de l’heure de référence gérée par le graphique homologue en valeur de temps localisée appropriée pour l’affichage sur l’ordinateur de l’homologue.
PeerGraphUniversalTimeToPeerTime	Convertit une valeur d’heure universelle de l’ordinateur de l’homologue en valeur de temps de graphique homologue commune.

Fonctions de connexion

Fonction	Description
peerGraphCloseDirectConnection	Ferme une connexion directe spécifiée.
peerGraphConnect	Tente d’établir une connexion à un nœud spécifié dans un graphique homologue. Cette fonction démarre une opération asynchrone.
PeerGraphEnumConnections	Crée et retourne un handle d’énumération utilisé pour énumérer les connexions d’un nœud local.
peerGraphOpenDirectConnection	Permet à une application d’établir une connexion directe avec un nœud dans un graphique homologue. La connexion ne peut être établie que si le nœud auquel l’application se connecte s’est abonné à l’événement PEER_GRAPH_EVENT_DIRECT_CONNECTION.
PeerGraphSendData	Envoie des données à un nœud voisin ou à un nœud directement connecté.

Fonctions d’infrastructure d’événements

Fonction	Description
PeerGraphGetEventData	Récupère les événements homologues.
PeerGraphRegisterEvent	Inscrit la demande d’un homologue pour être informé des modifications associées à un graphique homologue et au type d’événement.
PeerGraphUnregisterEvent	Demande que l’application ne soit plus avertie des modifications associées à un graphique homologue et à un type d’enregistrement.