PFNPEER_SECURE_RECORD回呼函式 (p2p.h)

PFNPEER_SECURE_RECORD回呼會指定對等圖形基礎結構呼叫來保護記錄的函式。

語法

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
)
{...}

參數

[in] hGraph

指定與指定記錄相關聯的對等圖形。

[in] pvContext

安全性內容的指標。 此參數指向 PEER_SECURITY_INTERFACE 結構的 pvContext 成員。

[in] pRecord

要保護之記錄的指標。

[in] changeType

指定驗證必須發生的原因。 PEER_RECORD_CHANGE_TYPE 列舉有效值。

[out] ppSecurityData

指定此記錄的安全性資料。 在複製數據並新增至記錄之後，呼叫 PEER_SECURITY_INTERFACEpfnFreeSecurityData 成員中指定的方法，以釋放此數據。

傳回值

如果此回呼成功，則會S_OK傳回值。

備註

每當應用程式呼叫任何修改記錄的方法時，都會叫用此回呼，例如 PeerGraphAddRecord 或 PeerGraphUpdateRecord。 此回呼
應該建立此記錄特有的數據，例如小型數字簽名，並透過 ppSecurityData 參數傳回它。 接著，此數據會新增至 securityData 成員中的記錄，並由 PEER_SECURITY_INTERFACE 的 pfnValidateRecord 成員所指定的方法進行驗證。

注意 當對等收到記錄時，此程式會在本機計算機上以及連接到圖形的任何對等發生。

 

如果不允許 changeType 參數指定的作業，回呼應該會傳回失敗碼，例如PEER_E_NOT_AUTHORIZED，而不是S_OK。

您可以從任何涉及記錄的對等圖形 API 函式叫用此回呼，例如 PeerGraphUpdateRecord。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h

另請參閱

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE