Gruppieren von API-Funktionen

Artikel
06/13/2023

Die Gruppierungs-API verwendet die folgenden Funktionen:

Gruppeninitialisierungs- und Bereinigungsfunktionen

Funktion	BESCHREIBUNG
PeerGroupShutdown	Schließt eine mit PeerGroupStartup erstellte Peergruppe und entsorgt alle zugeordneten Ressourcen.
PeerGroupStartup	Initiiert eine Peergruppe mithilfe einer angeforderten Version der Peerinfrastruktur.

Gruppenerstellungs- und Zugriffsfunktionen

Funktion	BESCHREIBUNG
PeerGroupClose	Ungültigisiert das Peergruppenhandle, das durch einen vorherigen Aufruf der Funktion PeerGroupCreate, PeerGroupJoin oder PeerGroupOpen abgerufen wurde.
PeerGroupConnect	Initiiert eine PNRP-Suche nach einer Peergruppe und versucht, eine Verbindung mit dieser herzustellen. Nachdem diese Funktion erfolgreich aufgerufen wurde, kann ein Peer mit anderen Mitgliedern der Peergruppe kommunizieren.
PeerGroupConnectByAddress	Versucht, eine Verbindung mit der Peergruppe herzustellen, an der andere Peers mit bekannten IPv6-Adressen teilnehmen.
PeerGroupCreate	Erstellt eine neue Peergruppe.
PeerGroupCreateInvitation	Gibt eine XML-Zeichenfolge zurück, die vom angegebenen Peer verwendet werden kann, um einer Gruppe beizutreten.
PeerGroupCreatePasswordInvitation	Gibt eine XML-Zeichenfolge zurück, die vom angegebenen Peer verwendet werden kann, um eine Gruppe mit einem übereinstimmenden Kennwort zu verknüpfen.
PeerGroupDelete	Löscht die lokalen Daten und das Zertifikat, die einer Peergruppe zugeordnet sind.
PeerGroupGetStatus	Ruft den aktuellen status einer Gruppe ab.
PeerGroupIssueCredentials	Gibt Anmeldeinformationen, einschließlich einer GMC, für eine bestimmte Identität aus und gibt optional eine XML-Einladungszeichenfolge zurück, die der eingeladene Peer verwenden kann, um einer Peergruppe beizutreten.
PeerGroupJoin	Ermöglicht einem Peer mit einer Einladung, einer vorhandenen Peergruppe beizutreten.
PeerGroupOpen	Öffnet eine Peergruppe, die von einem Peer erstellt oder hinzugefügt wurde.
PeerGroupParseInvitation	Gibt eine PEER_INVITATION_INFO-Struktur mit den Details einer bestimmten Einladung zurück.
PeerGroupPasswordJoin	Ermöglicht es einem Peer mit einer Einladung und dem richtigen Kennwort, einer kennwortgeschützten Peergruppe beizutreten.

Gruppen- und Memberinformationsfunktionen

Funktion	BESCHREIBUNG
PeerGroupEnumMembers	Erstellt eine Enumeration der verfügbaren Peergruppenmitglieder und der zugeordneten Mitgliedschaftsinformationen.
PeerGroupGetProperties	Ruft Informationen zu den Eigenschaften einer angegebenen Gruppe ab.
PeerGroupSetProperties	Legt die aktuellen Peergruppeneigenschaften fest. In Version 1.0 dieser API kann nur der Ersteller der Peergruppe diesen Vorgang ausführen.

Datensätze und Datensatzverwaltungsfunktionen

Funktion	BESCHREIBUNG
PeerGroupAddRecord	Fügt der Peergruppe einen neuen Datensatz hinzu, der an alle teilnehmenden Peers weitergegeben wird.
PeerGroupDeleteRecord	Löscht einen Datensatz aus einer Peergruppe. Nur der Ersteller eines Datensatzes kann ihn löschen.
PeerGroupEnumRecords	Erstellt eine Enumeration von Peergruppendatensätzen.
PeerGroupGetRecord	Ruft einen bestimmten Gruppendatensatz ab.
PeerGroupSearchRecords	Durchsucht die lokale Peergruppendatenbank nach Datensätzen, die den angegebenen Kriterien entsprechen.
PeerGroupUpdateRecord	Updates einen Datensatz innerhalb einer bestimmten Peergruppe.

Gruppendatenbank-Import-/Exportfunktionen

Funktion	BESCHREIBUNG
PeerGroupExportDatabase	Exportiert eine Peergruppendatenbank in eine bestimmte Datei, die auf einen anderen Computer übertragen und mit der Funktion PeerGroupImportDatabase importiert werden kann.
PeerGroupImportDatabase	Importiert eine Peergruppendatenbank aus einer lokalen Datei.

Direktverbindungsfunktionen

Funktion	BESCHREIBUNG
PeerGroupCloseDirectConnection	Schließt eine bestimmte direkte Verbindung zwischen zwei Peers.
PeerGroupEnumConnections	Erstellt eine Enumeration von Verbindungen, die derzeit auf dem Peer aktiv sind.
PeerGroupOpenDirectConnection	Stellt eine direkte Verbindung mit einem anderen Peer in einer Peergruppe her.
PeerGroupSendData	Sendet Daten über eine benachbarte oder direkte Verbindung an ein Element.

Infrastruktur für Gruppenereignisse

Funktion	BESCHREIBUNG
PeerGroupGetEventData	Ermöglicht einer Anwendung das Abrufen der von einem Gruppierungsereignis zurückgegebenen Daten.
PeerGroupRegisterEvent	Registriert einen Peer für bestimmte Peergruppenereignisse.
PeerGroupUnregisterEvent	Hebt die Registrierung eines Peers aus der Benachrichtigung über Peerereignisse auf, die dem angegebenen Ereignishandle zugeordnet sind.

Gruppenzeitkonvertierungsfunktionen

Funktion	BESCHREIBUNG
PeerGroupPeerTimeToUniversalTime	Konvertiert den von Peergruppen verwalteten Referenzzeitwert in einen lokalisierten Zeitwert, der für die Anzeige auf einem Peercomputer geeignet ist.
PeerGroupUniversalTimeToPeerTime	Konvertiert einen Lokalen Zeitwert vom Computer eines Peers in einen gemeinsamen Peergruppenzeitwert.

Gruppenkonfigurationsfunktionen

Funktion	BESCHREIBUNG
PeerGroupExportConfig	Exportiert die Gruppenkonfiguration für einen Peer als XML-Zeichenfolge, die die Identität, den Gruppennamen und den GMC für die Identität enthält.
PeerGroupImportConfig	Importiert eine Peergruppenkonfiguration für eine Identität basierend auf den spezifischen Einstellungen in einer angegebenen XML-Konfigurationszeichenfolge.