Arbeiten mit Graphen
Beim Arbeiten mit Peerdiagrammen müssen Funktionen in einer bestimmten Reihenfolge aufgerufen werden. Der Aufruffluss hängt davon ab, ob Sie ein Peerdiagramm erstellen oder öffnen. In diesem Thema wird der Ablauf von Funktionsaufrufen in einer einfachen Peergraphanwendung identifiziert.
Starten eines Graph
Bevor eine Anwendung eine Funktion in der Peergraphing-API aufruft, muss PeerGraphStartup aufgerufen werden, um die Peer graphing-API für eine Anwendung zu initialisieren und dann die unterstützte Version festzulegen.
Erstellen eines Peer-Graph
Das folgende Verfahren identifiziert den Aufruffluss zum Erstellen eines Peerdiagramms.
Wichtig
Nur ein Peer sollte PeerGraphCreateaufrufen. Alle anderen Peers sollten PeerGraphOpenaufrufen. Mehrere Aufrufe von PeerGraphCreate machen ein Diagramm ungültig.
Erstellen Sie ein Peerdiagramm. Rufen Sie PeerGraphCreate auf.
Registrieren Sie sich für Peerereignisse. Rufen Sie PeerGraphRegisterEventauf.
Hinweis
Weitere Informationen zum Registrieren für Peerereignisse finden Sie unter Ereignisinfrastruktur.
Lauschen auf Verbindungen mit einem Peerdiagramm. Rufen Sie PeerGraphListenauf.
Führen Sie anwendungsabhängige Funktionen für den Rest der Laufzeit aus, z. B. peer-Ereignisse verarbeiten und mit Verbindungen arbeiten.
Schließen Sie die Verbindung mit einem Peerdiagramm. Rufen Sie PeerGraphCloseauf.
Öffnen eines Peer-Graph
Der Fluss von Funktionsaufrufen zum Öffnen eines Peerdiagramms hängt vom Rückgabewert des Aufrufs von PeerGraphOpenab. Die wichtigsten Werte sind S _ OK und PEER S DATA _ _ _ CREATED, die in den folgenden Abschnitten dieses Themas erläutert werden.
Hinweis
Wenn ein Aufruf von PeerGraphOpen nicht S _ OK oder PEER S DATA _ _ _ CREATED zurückgibt, behandeln Sie den Fehler.
Wenn PeerGraphOpen "S OK" zurückgibt _
Wenn ein Aufruf von PeerGraphOpen S _ OK zurückgibt, wurden ein Peerdiagramm und eine vorhandene Datenbank geöffnet. Das folgende Verfahren gibt an, wie Sie einen Peergraphen öffnen können, wenn ein Aufruf von PeerGraphOpen S _ OK zurückgibt.
Registrieren Sie sich für Peerereignisse. Rufen Sie PeerGraphRegisterEventauf.
Hinweis
Weitere Informationen zum Registrieren für Ereignisse finden Sie unter Ereignisinfrastruktur.
Suchen Sie einen Knoten. Dies ist ein Prozess, der außerhalb der Peergraphinginfrastruktur mithilfe einer Methode oder Anwendung ausgeführt wird, die Sie identifizieren. Die Peergraphing-API bietet keinen bestimmten Mechanismus, um einen ersten Graphknoten zu finden, mit dem eine Verbindung hergestellt werden kann. Eine Anwendung muss einen anderen Mechanismus verwenden, z. B. die PNRP-API (Peer Name Resolution Protocol), um den ersten Knoten zu finden.
Wenn ein Knoten gefunden wird, stellen Sie eine Verbindung mit ihm her. Rufen Sie PeerGraphConnectauf, und rufen Sie dann PeerGraphListen auf, um auf Verbindungen mit dem Peerdiagramm zu lauschen.
Hinweis
Wenn kein Knoten gefunden wird, rufen Sie peerGraphConnect und PeerGraphListennicht auf.
Führen Sie anwendungsabhängige Funktionen für den Rest der Laufzeit aus, z. B. peer-Ereignisse verarbeiten und mit Verbindungen arbeiten, je nachdem, ob der Knoten mit dem Peerdiagramm verbunden ist oder nicht. Beispielsweise kann die Anwendung ein Timeout festlegen oder die Ermittlung für einen aktiven Knoten im Diagramm in regelmäßigen Abständen durchführen.
Schließen Sie die Verbindung mit dem Peerdiagramm. Rufen Sie PeerGraphCloseauf.
Wenn PeerGraphOpen PEER _ S _ DATA _ CREATED zurückgibt
Wenn PeerGraphOpen PEER S DATA _ _ _ CREATED zurückgibt, bedeutet dies, dass keine vorhandene Datenbank für ein Peerdiagramm gefunden wird, eine neue Datenbank erstellt wird, und dies ist das erste Mal, wenn sie geöffnet wird. Um ein Peerdiagramm verwenden oder an diesem lauschen zu können, muss ein Peer mit einem Peerdiagramm verbunden und mit diesem synchronisiert werden.
Das folgende Verfahren gibt an, wie Sie einen Peergraphen öffnen können, wenn ein Aufruf von PeerGraphOpen PEER S DATA _ _ _ CREATED zurückgibt.
Öffnen Sie ein Peerdiagramm. Rufen Sie PeerGraphOpen auf.
Registrieren Sie sich für Peerereignisse. Rufen Sie PeerGraphRegisterEventauf.
Hinweis
Weitere Informationen zum Registrieren für Peerereignisse finden Sie unter Ereignisinfrastruktur.
Suchen Sie einen Knoten. Dies ist ein Prozess, der außerhalb der Peergraphinginfrastruktur mithilfe einer Methode oder Anwendung ausgeführt wird, die Sie identifizieren. Die Peergraphing-API bietet keinen bestimmten Mechanismus, um einen ersten Graphknoten zu finden, mit dem eine Verbindung hergestellt werden kann. Eine Anwendung muss einen anderen Mechanismus verwenden, z. B. die PNRP-API (Peer Name Resolution Protocol), um den ersten Knoten zu finden.
Wenn ein Knoten gefunden wird, stellen Sie eine Verbindung mit ihm her. Rufen Sie PeerGraphConnectauf, und rufen Sie dann PeerGraphListen auf, um auf Verbindungen mit dem Peerdiagramm zu lauschen.
Hinweis
Wenn kein Knoten gefunden wird, rufen Sie peerGraphConnect und PeerGraphListennicht auf.
Führen Sie anwendungsabhängige Funktionen für den Rest der Laufzeit aus, z. B. peer-Ereignisse verarbeiten und mit Verbindungen arbeiten, je nachdem, ob der Knoten mit dem Peerdiagramm verbunden ist oder nicht. Beispielsweise kann die Anwendung ein Timeout festlegen oder die Ermittlung für einen aktiven Knoten im Diagramm in regelmäßigen Abständen durchführen.
Schließen Sie die Verbindung mit dem Peerdiagramm. Rufen Sie PeerGraphCloseauf.