PFNPEER_SECURE_RECORD fungsi panggilan balik (p2p.h)

Artikel
02/21/2025

Panggilan balik PFNPEER_SECURE_RECORD menentukan fungsi yang dipanggil Infrastruktur Grafik Serekan untuk mengamankan rekaman.

Sintaks

PFNPEER_SECURE_RECORD PfnpeerSecureRecord;

HRESULT PfnpeerSecureRecord(
  [in]  HGRAPH hGraph,
  [in]  PVOID pvContext,
  [in]  PPEER_RECORD pRecord,
  [in]  PEER_RECORD_CHANGE_TYPE changeType,
  [out] PPEER_DATA *ppSecurityData
)
{...}

Parameter

[in] hGraph

Menentukan grafik serekan yang terkait dengan rekaman yang ditentukan.

[in] pvContext

Arahkan ke konteks keamanan. Parameter ini menunjuk ke anggota pvContext dari struktur PEER_SECURITY_INTERFACE .

[in] pRecord

Arahkan ke rekaman untuk mengamankan.

[in] changeType

Menentukan alasan validasi harus terjadi. PEER_RECORD_CHANGE_TYPE menghitung nilai yang valid.

[out] ppSecurityData

Menentukan data keamanan untuk rekaman ini. Data ini dirilis dengan memanggil metode yang ditentukan dalam anggota pfnFreeSecurityData dari PEER_SECURITY_INTERFACE setelah data disalin dan ditambahkan ke rekaman.

Nilai kembali

Jika panggilan balik ini berhasil, nilai yang dikembalikan adalah S_OK.

Keterangan

Panggilan balik ini dipanggil setiap kali aplikasi memanggil salah satu metode yang memodifikasi rekaman, seperti PeerGraphAddRecord atau PeerGraphUpdateRecord. Panggilan balik ini
harus membuat data yang khusus untuk rekaman ini, seperti tanda tangan digital kecil, dan mengembalikannya melalui parameter ppSecurityData . Data ini kemudian ditambahkan ke rekaman di anggota securityData , dan diverifikasi oleh metode yang ditentukan oleh anggota pfnValidateRecord dari PEER_SECURITY_INTERFACE.

Catatan Proses ini terjadi pada komputer lokal serta serekan apa pun yang tersambung ke grafik ketika serekan menerima rekaman.

Jika operasi yang ditentukan oleh parameter changeType tidak diizinkan, panggilan balik harus mengembalikan kode kegagalan, seperti PEER_E_NOT_AUTHORIZED, bukan S_OK.

Panggilan balik ini dapat dipanggil dari salah satu fungsi PEER Graphing API yang melibatkan rekaman, seperti PeerGraphUpdateRecord.

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

Lihat juga

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

Bagikan melalui