Fonctions d’API de regroupement

Article
03/13/2025

L’API de regroupement utilise les fonctions suivantes :

Fonctions d’initialisation et de nettoyage de groupe

Fonction	Description
PeerGroupShutdown	Ferme un groupe d’homologues créé avec PeerGroupStartup et supprime toutes les ressources allouées.
PeerGroupStartup	Lance un groupe d’homologues à l’aide d’une version demandée de l’infrastructure homologue.

Fonctions de création et d’accès de groupe

Fonction	Description
PeerGroupClose	Invalide le handle de groupe d’homologues obtenu par un appel précédent à l'PeerGroupCreate, PeerGroupJoinou fonction PeerGroupOpen.
PeerGroupConnect	Lance une recherche PNRP pour un groupe d’homologues et tente de se connecter à celui-ci. Une fois cette fonction appelée, un homologue peut communiquer avec d’autres membres du groupe homologue.
PeerGroupConnectByAddress	Tente de se connecter au groupe homologue auquel participent d’autres homologues avec des adresses IPv6 connues.
PeerGroupCreate	Crée un groupe d’homologues.
PeerGroupCreateInvitation	Retourne une chaîne XML qui peut être utilisée par l’homologue spécifié pour joindre un groupe.
PeerGroupCreatePasswordInvitation	Retourne une chaîne XML qui peut être utilisée par l’homologue spécifié pour joindre un groupe avec un mot de passe correspondant.
peerGroupDelete	Supprime les données locales et le certificat associés à un groupe homologue.
peerGroupGetStatus	Récupère l’état actuel d’un groupe.
PeerGroupIssueCredentials	Émet des informations d’identification, y compris un GMC, à une identité spécifique, et retourne éventuellement une chaîne XML d’invitation que l’homologue invité peut utiliser pour joindre un groupe d’homologues.
peerGroupJoin	Autorise un homologue avec une invitation à rejoindre un groupe d’homologues existant.
PeerGroupOpen	Ouvre un groupe d’homologues créé ou joint à un homologue.
PeerGroupParseInvitation	Retourne une structure PEER_INVITATION_INFO avec les détails d’une invitation spécifique.
PeerGroupPasswordJoin	Permet à un homologue avec une invitation et le mot de passe approprié de joindre un groupe d’homologues protégé par mot de passe.

Fonctions d’informations de groupe et de membre

Fonction	Description
PeerGroupEnumMembers	Crée une énumération des membres de groupe homologue disponibles et les informations d’appartenance associées.
PeerGroupGetProperties	Récupère des informations sur les propriétés d’un groupe spécifié.
PeerGroupSetProperties	Définit les propriétés actuelles du groupe d’homologues. Dans la version 1.0 de cette API, seul le créateur du groupe homologue peut effectuer cette opération.

Fonctions de gestion des enregistrements et des enregistrements

Fonction	Description
PeerGroupAddRecord	Ajoute un nouvel enregistrement au groupe homologue, qui est propagé à tous les homologues participants.
PeerGroupDeleteRecord	Supprime un enregistrement d’un groupe d’homologues. Seul le créateur d’un enregistrement peut le supprimer.
PeerGroupEnumRecords	Crée une énumération d’enregistrements de groupe d’homologues.
peerGroupGetRecord	Récupère un enregistrement de groupe spécifique.
PeerGroupSearchRecords	Recherche les enregistrements correspondant aux critères fournis dans la base de données de groupe homologue local.
PeerGroupUpdateRecord	Met à jour un enregistrement au sein d’un groupe d’homologues spécifique.

Fonctions d’importation/exportation de base de données de groupe

Fonction	Description
PeerGroupExportDatabase	Exporte une base de données de groupe homologue vers un fichier spécifique, qui peut être transporté vers un autre ordinateur et importée avec la fonction PeerGroupImportDatabase.
PeerGroupImportDatabase	Importe une base de données de groupe homologue à partir d’un fichier local.

Fonctions de connexion directe

Fonction	Description
PeerGroupCloseDirectConnection	Ferme une connexion directe spécifique entre deux homologues.
PeerGroupEnumConnections	Crée une énumération des connexions actuellement actives sur l’homologue.
peerGroupOpenDirectConnection	Établit une connexion directe avec un autre homologue dans un groupe d’homologues.
PeerGroupSendData	Envoie des données à un membre via un voisin ou une connexion directe.

Infrastructure des événements de groupe

Fonction	Description
PeerGroupGetEventData	Permet à une application de récupérer les données retournées par un événement de regroupement.
PeerGroupRegisterEvent	Inscrit un homologue pour des événements de groupe d’homologues spécifiques.
PeerGroupUnregisterEvent	Annule l’inscription d’un homologue à partir de la notification des événements homologues associés au handle d’événement fourni.

Fonctions de conversion de temps de groupe

Fonction	Description
PeerGroupPeerTimeToUniversalTime	Convertit la valeur de l’heure de référence gérée par le groupe homologue en valeur de temps localisée appropriée pour l’affichage sur un ordinateur homologue.
PeerGroupUniversalTimeToPeerTime	Convertit une valeur d’heure locale de l’ordinateur d’un homologue en valeur de temps de groupe homologue commune.

Fonctions de configuration de groupe

Fonction	Description
PeerGroupExportConfig	Exporte la configuration de groupe pour un homologue sous la forme d’une chaîne XML qui contient l’identité, le nom du groupe et la console GMC pour l’identité.
peerGroupImportConfig	Importe une configuration de groupe homologue pour une identité en fonction des paramètres spécifiques d’une chaîne de configuration XML fournie.