Bekerja dengan Grafik
Saat bekerja dengan grafik serekan, fungsi harus dipanggil dalam urutan tertentu. Alur panggilan tergantung pada apakah Anda membuat atau membuka grafik serekan. Topik ini mengidentifikasi alur panggilan fungsi dalam aplikasi grafik serekan sederhana.
Memulai Grafik
Sebelum aplikasi memanggil fungsi di PEER Graphing API, PeerGraphStartup harus dipanggil untuk menginisialisasi PEER Graphing API untuk aplikasi, lalu mengatur versi yang didukung.
Membuat Grafik Serekan
Prosedur berikut mengidentifikasi alur panggilan untuk membuat grafik serekan.
Penting
Hanya satu peer yang harus memanggil PeerGraphCreate. Semua rekan lain harus memanggil PeerGraphBuka. Beberapa panggilan ke PeerGraphCreate membatalkan grafik.
Membuat grafik serekan. Panggil PeerGraphBuat.
Daftar untuk peristiwa serekan. Panggil PeerGraphRegisterEvent.
Catatan
Untuk informasi selengkapnya tentang mendaftar untuk peristiwa serekan, lihat Infrastruktur Peristiwa.
Dengarkan koneksi ke grafik serekan. Panggil PeerGraphListen.
Lakukan fungsi yang bergantung pada aplikasi selama sisa waktu berjalan, misalnya, memproses peristiwa serekan dan bekerja dengan koneksi.
Tutup koneksi ke grafik serekan. Panggil PeerGraphClose.
Membuka Grafik Serekan
Alur panggilan fungsi untuk membuka grafik serekan tergantung pada nilai pengembalian panggilan ke PeerGraphOpen. Nilai yang paling penting adalah S_OK dan PEER_S_DATA_CREATED, yang dijelaskan di bagian berikut dari topik ini.
Catatan
Jika panggilan ke PeerGraphOpen tidak mengembalikan S_OK atau PEER_S_DATA_CREATED, tangani kesalahan.
Saat PeerGraphBuka Mengembalikan S_OK
Saat panggilan ke PeerGraphOpen mengembalikan S_OK, grafik serekan dan database yang sudah ada telah dibuka. Prosedur berikut mengidentifikasi apa yang bisa Anda lakukan untuk membuka grafik serekan saat panggilan ke PeerGraphBuka mengembalikan S_OK
Daftar untuk peristiwa serekan. Panggil PeerGraphRegisterEvent.
Catatan
Untuk informasi selengkapnya tentang mendaftar untuk peristiwa, lihat Infrastruktur Peristiwa.
Temukan simpul. Ini adalah proses yang dilakukan di luar Infrastruktur Grafik Serekan, dengan menggunakan metode atau aplikasi yang Anda identifikasi. PEER Graphing API tidak menyediakan mekanisme tertentu untuk menemukan simpul grafik awal untuk disambungkan. Aplikasi harus menggunakan mekanisme lain, seperti PEER Name Resolution Protocol (PNRP) API, untuk menemukan simpul awal.
Jika simpul ditemukan, sambungkan ke simpul tersebut. Panggil PeerGraphConnect, lalu panggil PeerGraphListen untuk mendengarkan koneksi ke grafik peer.
Catatan
Jika simpul tidak ditemukan, jangan panggil PeerGraphConnect dan PeerGraphListen.
Lakukan fungsi yang bergantung pada aplikasi selama sisa waktu berjalan, misalnya, memproses peristiwa serekan dan bekerja dengan koneksi, tergantung pada apakah simpul terhubung ke grafik serekan atau tidak. Misalnya, aplikasi dapat memilih untuk batas waktu atau secara berkala melakukan penemuan untuk simpul aktif dalam grafik.
Tutup koneksi ke grafik serekan. Panggil PeerGraphClose.
Saat PeerGraphBuka Pengembalian PEER_S_DATA_CREATED
Saat PeerGraphOpen mengembalikan PEER_S_DATA_CREATED, itu berarti bahwa database yang ada untuk grafik serekan tidak ditemukan, database baru dibuat, dan ini adalah pertama kalinya database dibuka. Untuk menggunakan atau mendengarkan grafik serekan, serekan harus disambungkan dan disinkronkan dengan grafik serekan.
Prosedur berikut mengidentifikasi apa yang dapat Anda lakukan untuk membuka grafik serekan saat panggilan ke PeerGraphBuka mengembalikan PEER_S_DATA_CREATED.
Buka grafik serekan. Panggil PeerGraphBuka.
Daftar untuk peristiwa serekan. Panggil PeerGraphRegisterEvent.
Catatan
Untuk informasi selengkapnya tentang mendaftar untuk peristiwa serekan, lihat Infrastruktur Peristiwa.
Temukan simpul. Ini adalah proses yang dilakukan di luar Infrastruktur Grafik Serekan, dengan menggunakan metode atau aplikasi yang Anda identifikasi. PEER Graphing API tidak menyediakan mekanisme tertentu untuk menemukan simpul grafik awal untuk disambungkan. Aplikasi harus menggunakan mekanisme lain, seperti PEER Name Resolution Protocol (PNRP) API, untuk menemukan simpul awal.
Jika simpul ditemukan, sambungkan ke simpul tersebut. Panggil PeerGraphConnect, lalu panggil PeerGraphListen untuk mendengarkan koneksi ke grafik peer.
Catatan
Jika simpul tidak ditemukan, jangan panggil PeerGraphConnect dan PeerGraphListen.
Lakukan fungsi yang bergantung pada aplikasi selama sisa waktu berjalan, misalnya, memproses peristiwa serekan dan bekerja dengan koneksi, tergantung pada apakah simpul terhubung ke grafik serekan atau tidak. Misalnya, aplikasi dapat memilih untuk batas waktu atau secara berkala melakukan penemuan untuk simpul aktif dalam grafik.
Tutup koneksi ke grafik serekan. Panggil PeerGraphClose.