struktur PEER_GRAPH_PROPERTIES (p2p.h)

Artikel
08/25/2023

Struktur PEER_GRAPH_PROPERTIES berisi data tentang kebijakan grafik serekan, ID, cakupan, dan informasi lainnya.

Sintaks

typedef struct peer_graph_properties_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwScope;
  DWORD dwMaxRecordSize;
  PWSTR pwzGraphId;
  PWSTR pwzCreatorId;
  PWSTR pwzFriendlyName;
  PWSTR pwzComment;
  ULONG ulPresenceLifetime;
  ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;

Anggota

dwSize

Menentukan ukuran, dalam byte, dari struktur data ini. Anggota dwSize harus diatur ke ukuran PEER_GRAPH_PROPERTIES sebelum memanggil PeerGraphCreate. Anggota ini diperlukan. Tidak ada nilai default.

dwFlags

Bendera yang mengontrol perilaku serekan dalam grafik. Defaultnya tidak memiliki set bendera. Nilai yang valid diidentifikasi dalam tabel berikut.

Nilai	Deskripsi
PEER_GRAPH_PROPERTY_DEFER_EXPIRATION	Menentukan kapan harus kedaluwarsa rekaman grafik. Ketika grafik tidak tersambung dan bendera ini diatur, kedaluwarsa tidak terjadi sampai grafik tersambung ke setidaknya satu anggota lain.

dwScope

Menentukan cakupan tempat ID grafik serekan diterbitkan. Nilai defaultnya adalah global. Nilai yang valid diidentifikasi dalam tabel berikut.

Nilai	Deskripsi
PEER_GRAPH_SCOPE_GLOBAL	Cakupan mencakup Internet.
PEER_GRAPH_SCOPE_LINK_LOCAL	Cakupan dibatasi untuk subnet lokal.
PEER_GRAPH_SCOPE_SITE_LOCAL	Cakupan dibatasi untuk situs, misalnya, intranet perusahaan.

dwMaxRecordSize

Menentukan nilai yang menunjukkan rekaman terbesar yang bisa ditambahkan ke grafik serekan. Nilai yang valid adalah nol (0), yang menunjukkan bahwa ukuran rekaman maksimum default digunakan (60 megabyte), dan nilai apa pun antara 1024 byte dan 60 megabyte.

pwzGraphId

Menentukan pengidentifikasi unik untuk grafik serekan. ID ini harus unik untuk pasangan komputer/pengguna. Anggota ini diperlukan dan tidak memiliki nilai default. Jika nilai string lebih besar dari 256 karakter (termasuk terminator null), kesalahan akan dikembalikan.

pwzCreatorId

Menentukan pengidentifikasi unik untuk pembuat grafik serekan. Anggota ini diperlukan dan tidak memiliki nilai default. Jika nilai string lebih besar dari 256 karakter (termasuk terminator null), kesalahan akan dikembalikan.

pwzFriendlyName

Menentukan nama yang mudah diingat dari grafik serekan. Anggota ini bersifat opsional dan dapat berupa NULL. Nilai defaultnya adalah NULL. Panjang maksimum string ini adalah 256 karakter, termasuk terminator null.

pwzComment

Menentukan komentar yang digunakan untuk menjelaskan grafik serekan. Anggota ini bersifat opsional dan dapat berupa NULL. Nilai defaultnya adalah NULL. Panjang maksimum string ini adalah 512 karakter, termasuk terminator null.

ulPresenceLifetime

Menentukan jumlah detik sebelum rekaman kehadiran kedaluwarsa. Nilai defaultnya adalah 300 detik (5 menit). Jangan atur nilai ulPresenceLifetime menjadi kurang dari 300 detik. Jika anggota ini diatur kurang dari nilai default 300 (5 menit), maka perilaku yang tidak ditentukan dapat terjadi.

cPresenceMax

Menentukan berapa banyak rekaman kehadiran yang disimpan Infrastruktur Serekan dalam grafik serekan pada satu waktu. Simpul yang memiliki kehadirannya diterbitkan dapat dijumlahkan oleh semua simpul lain dengan PeerGraphEnumNodes. Tentukan bagaimana rekaman kehadiran untuk pengguna diterbitkan dengan menentukan salah satu nilai yang diidentifikasi dalam tabel berikut ini.

Nilai	Deskripsi
-1	Rekaman kehadiran secara otomatis diterbitkan untuk semua pengguna.
0	Rekaman kehadiran tidak diterbitkan secara otomatis.
1-N	Hingga N jumlah rekaman kehadiran diterbitkan pada satu waktu. Catatan kehadiran yang diterbitkan dipilih secara acak oleh Infrastruktur Grafik Serekan.

Keterangan

Aplikasi dapat memaksa Infrastruktur Grafik Serekan untuk menerbitkan informasi kehadiran dengan menggunakan PeerGraphSetPresence.

Hanya bidang tertentu dalam PEER_GRAPH_PROPERTIES yang dapat diperbarui saat memanggil PeerGraphSetProperties. Anggota berikut dapat diperbarui:

pwzFriendlyName
pwzComment
ulPresenceLifetime
cPresenceMax

Anggota yang tersisa tidak dapat dimodifikasi.

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
Header	p2p.h

Lihat juga

PeerGraphBuat

PeerGraphGetProperties

PeerGraphSetProperties

Bagikan melalui