Graphing-API-Funktionen

Die Peergraphing-API verwendet die folgenden Funktionen:

Initialisierungs- und Bereinigungsfunktionen

Funktion Beschreibung
PeerGraphShutdown Bereinigt alle Ressourcen, die durch den Aufruf von PeerGraphStartupzugeordnet werden.
PeerGraphStartup Gibt der Peerdiagramminfrastruktur an, welche Version der Peerprotokolle für die aufrufende Anwendung erforderlich ist.

Graph Erstellungs- und Zugriffsfunktionen

Funktion Beschreibung
PeerGraphClose Macht das Peerdiagrammhandle ungültig, das durch einen Aufruf von PeerGraphCreate oder PeerGraphOpenzurückgegeben wird, und schließt alle Netzwerkverbindungen für das angegebene Peerdiagramm.
PeerGraphErzählen Erstellt ein neues Peerdiagramm.
PeerGraphDelete Löscht die einem angegebenen Peerdiagramm zugeordneten Daten.
PeerGraphListen Gibt an, dass ein Peerdiagramm auf eingehende Verbindungen lauschen soll.
PeerGraphOpen Öffnet ein Peerdiagramm, das zuvor entweder vom lokalen Knoten oder einem Remoteknoten erstellt wurde.

Graph- und Knoteninformationsfunktionen

Funktion Beschreibung
PeerGraphEnumNodes Erstellt ein Enumerationshandle, das zum Aufzählen der Knoten in einem Peerdiagramm verwendet wird, und gibt dieses zurück.
PeerGraphGetNodeInfo Ruft Informationen zu einem bestimmten Knoten ab.
PeerGraphGetProperties Ruft die aktuellen Peerdiagrammeigenschaften ab.
PeerGraphGetStatus Gibt den aktuellen Status des Peerdiagramms zurück.
PeerGraphSetNodeAttributes Legt die Attribute der PEER _ NODE _ INFO-Struktur für den lokalen Knoten fest.
PeerGraphSetPresence Aktiviert oder deaktiviert explizit die Veröffentlichung von Anwesenheitsdatensätzen für einen bestimmten Knoten. Diese Funktion kann die Anwesenheitseinstellungen in den Peerdiagrammeigenschaften überschreiben.
PeerGraphSetProperties Legt die Peerdiagrammeigenschaften fest.

Funktionen für die Datensatzverwaltung

Funktion Beschreibung
PeerGraphAddRecord Fügt einem Peerdiagramm einen neuen Datensatz hinzu. Ein mit dieser Funktion hinzugefügter Datensatz wird an jeden Knoten in einem Peerdiagramm gesendet.
PeerGraphDeleteRecord Markiert einen Datensatz in einem Peerdiagramm als gelöscht.
PeerGraphEnumRecords Erstellt ein Enumerationshandle, das zum Auflisten von Datensätzen eines bestimmten Datensatztyps, Benutzers oder beider Typen verwendet wird, und gibt dieses zurück.
PeerGraphGetRecord Ruft einen bestimmten Datensatz basierend auf der angegebenen Datensatz-ID ab.
PeerGraphSearchRecords Durchsucht das Peerdiagramm nach bestimmten Datensätzen.
PeerGraphUpdateRecord Aktualisiert einen Datensatz im Peerdiagramm und überflutet den Datensatz dann an jeden Knoten im Peerdiagramm.
PeerGraphValidateDeferredRecords Gibt der Peerdiagramminfrastruktur an, dass es an der Zeit ist, alle zurückgestellten Datensätze erneut zu übermitteln, die das Sicherheitsmodul überprüfen soll.

Export- und Importfunktionen

Funktion Beschreibung
PeerGraphExportDatabase Exportiert eine Peergraphdatenbank in eine Datei, die Sie auf einen anderen Computer verschieben können.
PeerGraphImportDatabase Importiert eine Datei, die die Informationen aus einer Peerdiagrammdatenbank enthält.

Hilfsprogramm- und Supportfunktionen

Funktion Beschreibung
PeerGraphEndEnumeration Gibt ein Enumerationshandle frei und gibt die einer Enumeration zugeordneten Ressourcen frei.
PeerGraphFreeData Gibt Ressourcen frei, die von mehreren Peer Graphing-API-Funktionen zurückgegeben werden.
PeerGraphGetItemCount Ruft die Anzahl der Elemente in einer Enumeration ab.
PeerGraphGetNextItem Ruft das nächste Element oder die nächsten Elemente in einer Enumeration ab, die durch einen Aufruf bestimmter Funktionen erstellt wurden, die eine Peerenumeration zurückgeben.
PeerGraphPeerTimeToUniversalTime Konvertiert den vom Peerdiagramm verwalteten Verweiszeitwert in einen lokalisierten Zeitwert, der für die Anzeige auf dem Computer des Peers geeignet ist.
PeerGraphUniversalTimeToPeerTime Konvertiert einen universellen Zeitwert vom Computer des Peers in einen allgemeinen Peerdiagrammzeitwert.

Verbindungsfunktionen

Funktion Beschreibung
PeerGraphCloseDirectConnection Schließt eine angegebene direkte Verbindung.
PeerGraphConnect Versucht, eine Verbindung mit einem angegebenen Knoten in einem Peerdiagramm herzustellen. Diese Funktion startet einen asynchronen Vorgang.
PeerGraphEnumConnections Erstellt ein Enumerationshandle, das zum Aufzählen der Verbindungen eines lokalen Knotens verwendet wird, und gibt dieses zurück.
PeerGraphOpenDirectConnection Ermöglicht es einer Anwendung, eine direkte Verbindung mit einem Knoten in einem Peerdiagramm herzustellen. Die Verbindung kann nur hergestellt werden, wenn der Knoten, mit dem die Anwendung eine Verbindung herstellt, das PEER GRAPH EVENT DIRECT _ _ _ _ CONNECTION-Ereignis abonniert hat.
PeerGraphSendData Sendet Daten an einen benachbarten Knoten oder einen direkt verbundenen Knoten.

Ereignisinfrastrukturfunktionen

Funktion Beschreibung
PeerGraphGetEventData Ruft Peerereignisse ab.
PeerGraphRegisterEvent Registriert die Anforderung eines Peers, über Änderungen benachrichtigt zu werden, die einem Peerdiagramm und einem Ereignistyp zugeordnet sind.
PeerGraphUnregisterEvent Fordert an, dass die Anwendung nicht mehr über Änderungen benachrichtigt wird, die einem Peerdiagramm und Datensatztyp zugeordnet sind.