Gruppieren von API-Funktionen

Die Gruppierungs-API verwendet die folgenden Funktionen:

Gruppenin initialisierungs- und Bereinigungsfunktionen

Funktion Beschreibung
PeerGroupShutdown Schließt eine Peergruppe, die mit PeerGroupStartup erstellt wurde, und gibt alle zugeordneten Ressourcen zurück.
PeerGroupStartup Initiiert eine Peergruppe mithilfe einer angeforderten Version der Peerinfrastruktur.

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.

Gruppen- und Memberinformationsfunktionen

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

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

Funktionen für direkte Verbindungen

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 ein.
PeerGroupSendData Sendet Daten über eine benachbarte oder direkte Verbindung an ein Mitglied.

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.