Teilen über

Gruppieren von API-Funktionen

  • Artikel

Die Gruppierungs-API verwendet die folgenden Funktionen:

Initialisierungs- und Bereinigungsfunktionen gruppieren

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

 

Gruppenerstellungs- und Zugriffsfunktionen

Funktion Beschreibung
PeerGroupClose- Ungültigiert das Peergruppenhandle, das durch einen vorherigen Aufruf der PeerGroupCreate, PeerGroupJoinoder PeerGroupOpen Funktion abgerufen 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- Versuche, 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 einer Gruppe mit einem übereinstimmenden Kennwort beizutreten.
PeerGroupDelete- Löscht die lokalen Daten und zertifikate, die einer Peergruppe zugeordnet sind.
PeerGroupGetStatus- Ruft den aktuellen Status einer Gruppe ab.
PeerGroupIssueCredentials Gibt Anmeldeinformationen, einschließlich einer GMC, an eine bestimmte Identität zurück und gibt optional eine XML-Einladungszeichenfolge zurück, die der eingeladene Peer für die Teilnahme an einer Peergruppe verwenden kann.
PeerGroupJoin- Ermöglicht einem Peer mit einer Einladung, einer vorhandenen Peergruppe beizutreten.
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, einer kennwortgeschützten Peergruppe beizutreten.

 

Gruppen- und Memberinformationsfunktionen

Funktion Beschreibung
PeerGroupEnumMembers Erstellt eine Aufzählung 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.

 

Datensatz- 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 Aufzählung 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.

 

Import-/Exportfunktionen für Gruppendatenbanken

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.

 

Direkte Verbindungsfunktionen

Funktion Beschreibung
PeerGroupCloseDirectConnection Schließt eine bestimmte direkte Verbindung zwischen zwei Peers.
PeerGroupEnumConnections- Erstellt eine Aufzählung 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 an ein Mitglied über eine Benachbarte oder direkte Verbindung.

 

Gruppenereignisseinfrastruktur

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

 

Gruppenzeitkonvertierungsfunktionen

Funktion Beschreibung
PeerGroupPeerTimeToUniversalTime Wandelt den Peergruppen-verwalteten Referenzzeitwert in einen lokalisierten Zeitwert um, der für die Anzeige auf einem Peercomputer geeignet ist.
PeerGroupUniversalTimeToPeerTime Wandelt einen lokalen Zeitwert vom Computer eines Peers in einen gemeinsamen Zeitwert für Peergruppen um.

 

Gruppenkonfigurationsfunktionen

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