Fungsi PeerGraphAddRecord (p2p.h)

Artikel
03/01/2024

Fungsi PeerGraphAddRecord menambahkan rekaman baru ke grafik serekan. Rekaman yang ditambahkan dengan fungsi ini dikirim ke setiap simpul dalam grafik serekan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Parameter

[in] hGraph

Menangani grafik serekan.

[in] pRecord

Penunjuk ke rekaman untuk ditambahkan.

[out] pRecordId

Menentukan ID rekaman yang secara unik mengidentifikasi rekaman dalam grafik serekan.

Nilai kembali

Jika panggilan fungsi berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, ia mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
E_ACCESSDENIED	Tidak dapat mengakses grafik serekan.
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_GRAPH_NOT_READY	Grafik tidak disinkronkan. Rekaman tidak dapat ditambahkan sampai grafik serekan disinkronkan.
PEER_E_GRAPH_SHUTTING_DOWN	PeerGraphClose telah dipanggil.
PEER_E_INVALID_ATTRIBUTES	Atribut yang ditentukan tidak cocok dengan skema.
PEER_E_INVALID_GRAPH	Handel ke grafik serekan tidak valid.
PEER_E_MAX_RECORD_SIZE_EXCEEDED	Rekaman melebihi ukuran maksimum yang diizinkan oleh grafik serekan.
PEER_E_NOT_INITIALIZED	Grafik harus diinisialisasi dengan panggilan ke PeerGraphStartup—sebelum menggunakan fungsi ini.

Keterangan

Anggota struktur PEER_RECORD berikut harus berisi nilai yang valid:

dwSize.
jenis .
ftExpiration - Harus lebih lambat dari waktu grafik saat ini, dan harus ditentukan dalam waktu serekan dengan menggunakan PeerGraphUniversalTimeToPeerTime.

Anggota struktur PEER_RECORD berikut bersifat opsional. Atur ke NULL jika tidak digunakan oleh aplikasi Anda:

data
pwzAttributes
securityData
dwVersion

Jika salah satu anggota berikut adalah NULL, PEER Graphing API melakukan perilaku default yang ditentukan:

pwzCreatorId - Menggunakan ID serekan yang diteruskan ke PeerGraphCreate atau PeerGraphOpen.
pwzModifiedById - Menggunakan pwzCreatorId.

Anggota berikut tidak dapat ditentukan; nilai apa pun yang digunakan ditimpa oleh infrastruktur Peer Graphing:

id.
ftCreation - Menggunakan waktu peer.
ftLastModified - Menggunakan waktu serekan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Paket Jaringan Tingkat Lanjut untukWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2PGraph.lib
DLL	P2PGraph.dll

Lihat juga

PEER_RECORD

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate

Bagikan melalui