Graphing-API-Funktionen

Die Peer Graphing-API verwendet die folgenden Funktionen:

Initialisierungs- und Bereinigungsfunktionen

Funktion	Beschreibung
PeerGraphShutdown-	Bereinigt alle ressourcen, die durch den Aufruf von PeerGraphStartupzugeordnet werden.
PeerGraphStartup-	Gibt der Peer Graphing-Infrastruktur an, welche Version der Peerprotokolle die aufrufende Anwendung benötigt.

 

Graph-Erstellungs- und Zugriffsfunktionen

Funktion	Beschreibung
PeerGraphClose-	Ungültiges Peerdiagrammhandle, das von einem Aufruf von PeerGraphCreate oder PeerGraphOpenzurückgegeben wird, und schließt alle Netzwerkverbindungen für das angegebene Peerdiagramm.
PeerGraphCreate	Erstellt ein neues Peerdiagramm.
PeerGraphDelete-	Löscht die mit einem angegebenen Peerdiagramm verknüpften Daten.
PeerGraphListen-	Gibt an, dass ein Peerdiagramm mit der Überwachung eingehender Verbindungen beginnen soll.
PeerGraphOpen-	Öffnet ein Peerdiagramm, das zuvor vom lokalen Knoten oder einem Remoteknoten erstellt wurde.

 

Graph- und Knoteninformationsfunktionen

Funktion	Beschreibung
PeerGraphEnumNodes	Erstellt und gibt einen Enumerationshandle zurück, der zum Aufzählen der Knoten in einem Peerdiagramm verwendet wird.
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 Publikation von Anwesenheitsdatensätzen für einen bestimmten Knoten. Diese Funktion kann die Anwesenheitseinstellungen in den Peerdiagrammeigenschaften überschreiben.
PeerGraphSetProperties-	Legt die Peerdiagrammeigenschaften fest.

 

Datensatzverwaltungsfunktionen

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 als gelöscht in einem Peerdiagramm.
PeerGraphEnumRecords-	Erstellt und gibt ein Aufzählungshandle zurück, das zum Aufzählen von Datensätzen eines bestimmten Datensatztyps, benutzers oder beides verwendet wird.
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 dann den Datensatz auf jeden Knoten im Peerdiagramm.
PeerGraphValidateDeferredRecords	Gibt an, dass die Peer Graphing-Infrastruktur an der Zeit ist, alle zurückgestellten Datensätze für das Sicherheitsmodul erneut zu übermitteln, um zu überprüfen.

 

Exportieren und Importieren von Funktionen

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

 

Hilfs- und Supportfunktionen

Funktion	Beschreibung
PeerGraphEndEnumeration	Gibt ein Enumerationshandle frei und gibt die ressourcen frei, die einer Enumeration zugeordnet sind.
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 Aufzählung ab, die durch einen Aufruf bestimmter Funktionen erstellt wird, die eine Peerenumeration zurückgeben.
PeerGraphPeerTimeToUniversalTime	Wandelt den Peerdiagramm-verwalteten Referenzzeitwert in einen lokalisierten Zeitwert um, der für die Anzeige auf dem Computer des Peers geeignet ist.
PeerGraphUniversalTimeToPeerTime	Wandelt einen universellen Zeitwert vom Computer des Peers in einen gemeinsamen Peerdiagramm-Zeitwert um.

 

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 und gibt ein Aufzählungshandle zurück, das zum Aufzählen der Verbindungen eines lokalen Knotens verwendet wird.
PeerGraphOpenDirectConnection-	Ermöglicht 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 ereignis PEER_GRAPH_EVENT_DIRECT_CONNECTION 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 Ereignistyp zugeordnet sind.
PeerGraphUnregisterEvent-	Fordert an, dass die Anwendung nicht mehr über Änderungen benachrichtigt wird, die einem Peerdiagramm und Datensatztyp zugeordnet sind.