Fungsi PeerGraphOpen (p2p.h)

Artikel
03/15/2023

Fungsi PeerGraphOpen membuka grafik peer yang dibuat sebelumnya oleh simpul lokal atau simpul jarak jauh. Handel ke grafik serekan dikembalikan, tetapi koneksi jaringan tidak dibuat.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphOpen(
  [in]  PCWSTR                   pwzGraphId,
  [in]  PCWSTR                   pwzPeerId,
  [in]  PCWSTR                   pwzDatabaseName,
  [in]  PPEER_SECURITY_INTERFACE pSecurityInterface,
  [in]  ULONG                    cRecordTypeSyncPrecedence,
  [in]  const GUID               *pRecordTypeSyncPrecedence,
  [out] HGRAPH                   *phGraph
);

Parameter

[in] pwzGraphId

Menentukan ID grafik peer untuk dibuka. Pengidentifikasi ini harus sama dengan ID yang digunakan dalam panggilan ke PeerGraphCreate.

Catatan Serekan yang menentukan ID grafik yang tidak valid (panjang) dapat membuka dan berhasil tersambung ke grafik, tetapi serekan tidak dapat menerbitkan rekaman ke grafik, karena rekaman tidak dapat divalidasi.

[in] pwzPeerId

Menentukan ID unik peer yang membuka grafik.

[in] pwzDatabaseName

Menentukan nama database yang terkait dengan grafik serekan ini pada saat grafik dibuat atau dibuka untuk pertama kalinya.

[in] pSecurityInterface

Menentukan penyedia keamanan untuk grafik serekan. Parameter ini harus menentukan nilai yang sama dengan pSecurityInterface yang ditentukan dalam panggilan asli ke PeerGraphCreate.

[in] cRecordTypeSyncPrecedence

Menentukan jumlah jenis rekaman dalam parameter pRecordTypeSyncPrecedence .

[in] pRecordTypeSyncPrecedence

Menunjuk ke array jenis rekaman. Array ini menentukan urutan di mana rekaman dari jenis rekaman yang ditentukan disinkronkan. Urutannya bisa nol (0) ke N, di mana 0 adalah jenis rekaman pertama yang akan disinkronkan. Jika jenis rekaman tidak ditentukan dalam array, jenis catatan disinkronkan dalam urutan default setelah jenis yang ditentukan dalam array disinkronkan.

Tentukan NULL untuk menggunakan urutan default. Parameter ini harus NULL jika cRecordTypeSyncPrecedence adalah nol (0).

[out] phGraph

Menerima handel ke grafik serekan yang dibuka. Ketika handel ini tidak diperlukan atau diperlukan, bebaskan dengan memanggil PeerGraphClose.

Nilai kembali

Mengembalikan S_OK jika database yang ada berhasil dibuka. Jika tidak, fungsi mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_S_GRAPH_DATA_CREATED	Database yang sudah ada tidak ditemukan, dan database baru berhasil dibuat. Jika database yang ada ditemukan dan berhasil dibuka, S_OK dikembalikan.
PEER_E_INVALID_GRAPH	Handel ke grafik peer tidak valid.
PEER_E_NOT_INITIALIZED	Grafik serekan harus diinisialisasi dengan menggunakan panggilan ke PeerGraphStartup sebelum menggunakan fungsi ini.

Keterangan

Jika Anda telah mengembangkan SSP Anda sendiri, aplikasi Anda tidak boleh memanggil PEERGraphing API untuk mengakses data dalam database grafik, karena itu dapat menyebabkan situasi kebuntuan. Sebaliknya, aplikasi harus melihat salinan informasi yang di-cache.

Setelah PeerGraphOpen dipanggil, aplikasi dapat berlangganan peristiwa atau mengimpor database, atau keduanya.

Hingga grafik serekan disinkronkan setidaknya satu kali, banyak fungsi tidak tersedia (misalnya, PeerGraphListen atau salah satu fungsi manajemen rekaman), dan setiap panggilan yang dilakukan ke fungsi ini gagal. Grafik serekan disinkronkan setidaknya satu kali ketika salah satu hal berikut ini terjadi:

Panggilan ke PeerGraphOpen mengembalikan S_OK, yang berarti bahwa database yang sudah disinkronkan telah ditemukan.
Fungsi PeerGraphCreate telah dipanggil.
Peristiwa PEER_GRAPH_EVENT_STATUS_CHANGED telah dipicu, dan bendera PEER_GRAPH_STATUS_SYNCHRONIZED anggota dwStatus telah ditetapkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Advanced Networking Pack forWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2PGraph.lib
DLL	P2PGraph.dll

Lihat juga

PEER_SECURITY_INTERFACE

PeerGraphClose

PeerGraphBuat

PeerGraphListen

Bagikan melalui