Gruppieren von API-Funktionen
Artikel
08/23/2021
2 Minuten Lesedauer
Ist diese Seite hilfreich?
In diesem Artikel
Die Gruppierungs-API verwendet die folgenden Funktionen:
Gruppenin initialisierungs- und Bereinigungsfunktionen
Gruppenerstellungs- und Zugriffsfunktionen
Funktion
Beschreibung
PeerGroupClose
Erklärt das Peergruppenhandl für ungültig, das durch einen vorherigen Aufruf der PeerGroupCreate-, PeerGroupJoin- oder PeerGroupOpen-Funktion ermittelt wurde.
PeerGroupConnect
Initiiert eine PNRP-Suche nach einer Peergruppe und versucht, eine Verbindung damit 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.
PeerGroupErzeugen
Erstellt eine neue Peergruppe.
PeerGroupCreateInvitation
Gibt eine XML-Zeichenfolge zurück, die vom angegebenen Peer zum Beitreten zu einer Gruppe verwendet werden kann.
PeerGroupCreatePasswordInvitation
Gibt eine XML-Zeichenfolge zurück, die vom angegebenen Peer verwendet werden kann, um einer Gruppe mit einem übereinstimmenden Kennwort beizugeben.
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 gmc, an eine bestimmte Identität aus und gibt optional eine EINLADUNGS-XML-Zeichenfolge zurück, die der eingeladene Peer zum Beitreten zu einer Peergruppe verwenden kann.
PeerGroupJoin
Ermöglicht einem Peer mit einer Einladung den Beitritt zu einer vorhandenen Peergruppe.
PeerGroupOpen
Öffnet eine Peergruppe, die ein Peer erstellt oder beigetreten ist.
PeerGroupParseInvitation
Gibt eine PEER _ INVITATION _ INFO-Struktur mit den Details einer bestimmten Einladung zurück.
PeerGroupPasswordJoin
Ermöglicht einem Peer mit einer Einladung und dem richtigen Kennwort das Beitreten zu einer kennwortgeschützten Peergruppe.
Funktion
Beschreibung
PeerGroupEnumMembers
Erstellt eine Enumeration der verfügbaren Peergruppenmitglieder und der zugehörigen 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.
Funktionen für die Datensatz- und Datensatzverwaltung
Funktion
Beschreibung
PeerGroupAddRecord
Fügt der Peergruppe einen neuen Datensatz hinzu, der an alle beteiligten Peers propagiert 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
Aktualisiert einen Datensatz innerhalb einer bestimmten Peergruppe.
Gruppendatenbank-Import/Export Funktionen
Funktionen für direkte Verbindungen
Infrastruktur für Gruppenereignisse
Funktion
Beschreibung
PeerGroupGetEventData
Ermöglicht es einer Anwendung, die von einem Gruppierungsereignis zurückgegebenen Daten abzurufen.
PeerGroupRegisterEvent
Registriert einen Peer für bestimmte Peergruppenereignisse.
PeerGroupUnregisterEvent
Aufheben der Registrierung eines Peers bei der Benachrichtigung von Peerereignissen, die dem angegebenen Ereignishand handle zugeordnet sind.
Funktionen für die Gruppenzeitkonvertierung
Funktion
Beschreibung
PeerGroupPeerTimeToUniversalTime
Konvertiert den von der Peergruppe verwalteten Verweiszeitwert 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.