struktur PEER_RECORD (p2p.h)

Artikel
03/15/2023

Struktur PEER_RECORD berisi objek rekaman yang digunakan aplikasi.

Sintaks

typedef struct peer_record_tag {
  DWORD     dwSize;
  GUID      type;
  GUID      id;
  DWORD     dwVersion;
  DWORD     dwFlags;
  PWSTR     pwzCreatorId;
  PWSTR     pwzModifiedById;
  PWSTR     pwzAttributes;
  FILETIME  ftCreation;
  FILETIME  ftExpiration;
  FILETIME  ftLastModified;
  PEER_DATA securityData;
  PEER_DATA data;
} PEER_RECORD, *PPEER_RECORD;

Anggota

dwSize

Menentukan ukuran struktur. Atur nilai ke sizeof(PEER_RECORD).

type

Menentukan jenis rekaman. Jenisnya adalah GUID yang harus ditentukan aplikasi. GUID mewakili jenis catatan unik, misalnya, rekaman obrolan.

id

Menentukan ID unik rekaman. Infrastruktur Serekan menyediakan ID ini. Parameter ini diabaikan dalam panggilan ke PeerGroupAddRecord. Aplikasi tidak dapat mengubah anggota ini.

dwVersion

Menentukan versi rekaman yang disediakan Infrastruktur Serekan saat aplikasi memanggil PeerGraphAddRecord atau PeerGraphUpdateRecord. Aplikasi tidak dapat mengubah anggota ini.

dwFlags

Menentukan bendera yang menunjukkan pemrosesan khusus, yang harus diterapkan ke rekaman. Tabel berikut mengidentifikasi nilai yang valid.

Nilai	Deskripsi
PEER_RECORD_FLAG_AUTOREFRESH	Menunjukkan bahwa rekaman di-refresh secara otomatis saat siap untuk kedaluwarsa.
PEER_RECORD_FLAG_DELETED	Menunjukkan bahwa rekaman ditandai sebagai dihapus.

Catatan Aplikasi tidak dapat mengatur bendera ini.

pwzCreatorId

Arahkan ke ID unik pembuat rekaman. Anggota ini diatur ke NULL untuk panggilan ke PeerGraphAddRecord dan PeerGraphUpdateRecord. Aplikasi tidak dapat mengatur anggota ini.

pwzModifiedById

Menentukan ID unik orang terakhir yang mengubah rekaman. Aplikasi tidak dapat mengatur anggota ini.

pwzAttributes

Penunjuk ke kumpulan nama atribut dan pasangan nilai yang terkait dengan rekaman. Anggota ini menunjuk ke string XML. Atribut rekaman ditentukan sebagai string XML, dan harus konsisten dengan skema atribut rekaman Infrastruktur Serekan. Untuk penjelasan lengkap tentang skema XML, lihat Skema Atribut Rekaman.

Infrastruktur Serekan mencadangkan beberapa nama atribut yang tidak dapat diatur pengguna. Daftar berikut mengidentifikasi nama atribut yang dipesan:

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
waktu peerkreasi
peerlastmodificationtime

ftCreation

Menentukan Waktu Universal Terkoordinasi (UTC) tempat rekaman dibuat. Infrastruktur Serekan menyediakan nilai ini, dan nilainya diatur ke nol (0) dalam panggilan ke PeerGroupAddRecord. Aplikasi tidak dapat mengatur anggota ini.

ftExpiration

Waktu UTC rekaman kedaluwarsa. Anggota ini diperlukan. Ini dapat diperbarui ke nilai waktu yang lebih besar dari nilai waktu yang semula ditentukan, tetapi tidak boleh kurang dari nilai yang ditentukan awal.

Catatan Jika dwFlags diatur ke PEER_RECORD_FLAG_AUTOREFRESH, jangan atur nilai ftExpiration menjadi kurang dari empat (4) menit. Jika anggota ini diatur ke kurang dari empat (4) menit, perilaku yang tidak ditentukan dapat terjadi.

ftLastModified

Waktu UTC yang dimodifikasi rekaman. Infrastruktur Serekan memasok nilai ini. Atur anggota ini ke NULL saat memanggil PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord, dan PeerGroupUpdateRecord. Aplikasi tidak dapat mengatur anggota ini.

securityData

Menentukan data keamanan yang terkandung dalam struktur PEER_DATA . Graphing API menggunakan anggota ini, dan menyediakan tempat bagi penyedia keamanan untuk menyimpan data keamanan, misalnya, tanda tangan. API Pengelompokan tidak dapat mengubah anggota ini.

data

Menentukan data aktual yang dimuat rekaman ini.

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