Fungsi PeerGraphCreate (p2p.h)

Artikel
03/13/2024

Fungsi PeerGraphCreate membuat grafik peer baru. Aplikasi dapat menentukan informasi tentang grafik serekan, dan jenis keamanan yang digunakan grafik serekan. Handel ke grafik serekan dikembalikan, tetapi koneksi jaringan tidak dibuat.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphCreate(
  [in]  PPEER_GRAPH_PROPERTIES   pGraphProperties,
  [in]  PCWSTR                   pwzDatabaseName,
  [in]  PPEER_SECURITY_INTERFACE pSecurityInterface,
  [out] HGRAPH                   *phGraph
);

Parameter

[in] pGraphProperties

Semua properti grafik serekan dalam struktur PEER_GRAPH_PROPERTIES .

[in] pwzDatabaseName

Nama database rekaman yang akan dikaitkan dengan grafik serekan saat dibuat. Nama database rekaman harus berupa nama file yang valid. Jangan sertakan jalur dengan nama file. Untuk daftar lengkap aturan mengenai nama file, lihat Penamaan item File dalam daftar Reference_Links Grafik.

[in] pSecurityInterface

Informasi tentang penyedia keamanan untuk grafik serekan dalam struktur PEER_SECURITY_INTERFACE .

[out] phGraph

Menerima handel ke grafik peer yang dibuat. Ketika handel ini tidak diperlukan lagi, bebaskan dengan memanggil PeerGraphClose.

Nilai kembali

Mengembalikan S_OK jika operasi berhasil. 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_E_DUPLICATE_GRAPH	Database dengan ID grafik serekan tertentu yang sudah ada.
PEER_E_NOT_INITIALIZED	Grafik serekan harus diinisialisasi dengan panggilan ke PeerGraphStartup sebelum menggunakan fungsi ini.

Keterangan

Jika Anda mengembangkan Penyedia Layanan Keamanan (SSP) Anda sendiri, aplikasi Anda tidak boleh memanggil PEER Graphing API untuk mengakses data dalam database grafik serekan, karena itu dapat menyebabkan situasi kebuntuan. Sebagai gantinya, aplikasi harus menggunakan salinan informasi yang di-cache. Salinan yang di-cache tidak dibuat oleh PEER Graphing API. Aplikasi harus menyediakan mekanisme untuk penembolokan data ini.

Setelah PeerGraphCreate dipanggil, aplikasi dapat berlangganan peristiwa sebelum memanggil PeerGraphListen.

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