Bagikan melalui

Fungsi PeerGroupAddRecord (p2p.h)

  • Artikel

Fungsi PeerGroupAddRecord menambahkan rekaman baru ke grup serekan, yang disebarkan ke semua rekan yang berpartisipasi.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Parameter

[in] hGroup

Menangani ke grup serekan. Handel ini dikembalikan oleh fungsi PeerGroupCreate, PeerGroupOpen, atau PeerGroupJoin . Parameter ini diperlukan.

[in] pRecord

Penunjuk ke struktur PEER_RECORD yang ditambahkan ke grup serekan yang ditentukan dalam hGroup. Parameter ini diperlukan.

Anggota berikut dalam PEER_RECORD harus diisi.

  • dwSize
  • jenis
  • ftExpiration
ftExpiration harus dinyatakan sebagai waktu serekan (lihat PeerGroupUniversalTimeToPeerTime).

Anggota berikut diabaikan dan ditimpa jika diisi.

  • id
  • pwzCreatorId
  • pwzLastModifiedById
  • ftCreation
  • ftLastModified
  • securityData
Bidang yang tersisa adalah opsional.

[out] pRecordId

Penunjuk ke GUID yang mengidentifikasi rekaman. Parameter ini diperlukan.

Nilai kembali

Mengembalikan S_OK jika fungsi 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_GROUP_NOT_READY
 Grup serekan tidak dalam status di mana rekaman bisa ditambahkan. Misalnya, PeerGroupJoin dipanggil, tetapi sinkronisasi dengan database grup serekan belum selesai.
PEER_E_INVALID_ATTRIBUTES
 String XML yang berisi atribut rekaman di anggota pwzAttributes dari struktur PEER_RECORD tidak mematuhi spesifikasi skema.
PEER_E_INVALID_GROUP
 Handel ke grup serekan tidak valid.
PEER_E_INVALID_PEER_NAME
 Nama serekan yang disediakan tidak valid.
PEER_E_INVALID_RECORD
 Satu atau beberapa bidang dalam PEER_RECORD tidak valid.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 Rekaman telah melebihi ukuran maksimum yang diizinkan oleh properti grup serekan.
PEER_E_NOT_AUTHORIZED
 Identitas tidak berwenang untuk menerbitkan rekaman jenis tersebut.
 

Kesalahan khusus kriptografi dapat dikembalikan dari Penyedia Dasar Microsoft RSA. Kesalahan ini diawali dengan CRYPT_* dan didefinisikan dalam Winerror.h.

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 P2P.lib
DLL P2P.dll

Lihat juga

PEER_RECORD

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupUpdateRecord