Praca z wykresami

Podczas pracy z grafami równorzędnymi funkcje muszą być wywoływane w określonej kolejności. Przepływ wywołań zależy od tego, czy tworzysz, czy otwierasz graf rówieśniczy. W tym temacie przedstawiono przepływ wywołań funkcji w prostej aplikacji grafu równorzędnego.

Uruchamianie grafu

Zanim aplikacja wywołuje funkcję w interfejsie API tworzenia wykresów równorzędnych, PeerGraphStartup należy wywołać w celu zainicjowania interfejsu API funkcji Peer Graphing dla aplikacji, a następnie ustawić obsługiwaną wersję.

Tworzenie grafu równorzędnego

Poniższa procedura identyfikuje przepływ wywołań do tworzenia grafu równorzędnego.

• Utwórz graf równorzędny. Wywołaj PeerGraphUtwórz.

• Zarejestruj się na wydarzenia branżowe. Wywołaj PeerGraphRegisterEvent.

  Notatka

  Aby uzyskać więcej informacji na temat rejestracji na wydarzenia partnerskie, sprawdź Events Infrastructure.

   

• Nasłuchiwanie połączeń z grafem równorzędnym. Wywołaj PeerGraphListen.

• Wykonuj funkcje zależne od aplikacji przez resztę czasu działania, na przykład przetwarzaj zdarzenia równorzędne i pracuj z połączeniami.

• Zamknij połączenie z grafem równorzędnym. Wywołaj PeerGraphClose.

Otwieranie grafu równorzędnego

Przepływ wywołań funkcji w celu otwarcia grafu równorzędnego zależy od wartości zwracanej wywołania PeerGraphOpen. Najważniejsze wartości to S_OK i PEER_S_DATA_CREATED, które zostały wyjaśnione w poniższych sekcjach tego tematu.

Gdy element PeerGraphOpen zwraca S_OK

Gdy wywołanie metody PeerGraphOpen zwraca S_OK, zostanie otwarty graf równorzędny i istniejąca baza danych. Poniższa procedura określa, co można zrobić, aby otworzyć graf równorzędny, gdy wywołanie metody PeerGraphOtwórz zwraca S_OK

• Zarejestruj się na wydarzenia z udziałem rówieśników. Wywołaj PeerGraphRegisterEvent.

  Notatka

  Aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz Events Infrastructure.

   

• Znajdź węzeł. Jest to proces wykonywany poza infrastrukturą tworzenia grafów równorzędnych przy użyciu metody lub aplikacji, którą identyfikujesz. Interfejs API tworzenia grafu równorzędnego nie zapewnia określonego mechanizmu znajdowania początkowego węzła grafu do nawiązania połączenia. Aby zlokalizować węzeł początkowy, aplikacja musi użyć innego mechanizmu, takiego jak Peer Name Resolution Protocol (PNRP) API.

• Jeśli węzeł zostanie znaleziony, połącz się z nim. Wywołaj PeerGraphConnect, a następnie wywołaj PeerGraphListen, aby nasłuchiwać połączeń z grafem równorzędnym.

  Notatka

  Jeśli węzeł nie zostanie znaleziony, nie wywołaj PeerGraphConnect i PeerGraphListen.

   

• Wykonywanie funkcji zależnych od aplikacji dla pozostałej części czasu działania, na przykład przetwarzania zdarzeń równorzędnych i pracy z połączeniami, w zależności od tego, czy węzeł jest połączony z grafem równorzędnym, czy nie. Na przykład aplikacja może zdecydować się na zakończenie działania po upływie czasu lub okresowo przeprowadzać wykrywanie dla aktywnego węzła w grafie.

• Zamknij połączenie z grafem równorzędnym. Wywołaj PeerGraphClose.

Gdy element PeerGraphOpen zwraca PEER_S_DATA_CREATED

Gdy PeerGraphOpen zwraca PEER_S_DATA_CREATED, oznacza to, że nie została znaleziona istniejąca baza danych dla grafu równorzędnego, więc została utworzona nowa baza danych i otwarto ją po raz pierwszy. Aby można było używać grafu równorzędnego lub nasłuchiwać, element równorzędny musi być połączony i zsynchronizowany z grafem równorzędnym.

Poniższa procedura określa, co można zrobić, aby otworzyć graf równorzędny, gdy wywołanie metody PeerGraphOpen zwraca PEER_S_DATA_CREATED.

• Otwórz graf równorzędny. Wywołaj PeerGraphOtwórz.

• Zarejestruj się na wydarzenia rówieśnicze. Wywołaj PeerGraphRegisterEvent.

  Notatka

  Aby uzyskać więcej informacji na temat rejestrowania się na wydarzenia rówieśnicze, zobacz Infrastruktura Wydarzeń.

   

• Znajdź węzeł. Jest to proces wykonywany poza infrastrukturą tworzenia grafów równorzędnych przy użyciu metody lub aplikacji, którą identyfikujesz. Interfejs API tworzenia grafu równorzędnego nie zapewnia określonego mechanizmu znajdowania początkowego węzła grafu do nawiązania połączenia. Aby zlokalizować węzeł początkowy, aplikacja musi użyć innego mechanizmu, takiego jak Peer Name Resolution Protocol (PNRP) API.

• Jeśli węzeł zostanie znaleziony, połącz się z nim. Wywołaj PeerGraphConnect, a następnie wywołaj PeerGraphListen, aby nasłuchiwać połączeń z grafem równorzędnym.

  Notatka

  Jeśli węzeł nie zostanie znaleziony, nie wywołaj PeerGraphConnect i PeerGraphListen.

   

• Wykonywanie funkcji zależnych od aplikacji dla pozostałej części czasu działania, na przykład przetwarzania zdarzeń równorzędnych i pracy z połączeniami, w zależności od tego, czy węzeł jest połączony z grafem równorzędnym, czy nie. Na przykład aplikacja może wybrać limit czasu lub okresowo wykonywać odnajdywanie dla aktywnego węzła na grafie.

• Zamknij połączenie z grafem równorzędnym. Wywołaj PeerGraphClose.