Share via

PFNPEER_VALIDATE_RECORD回呼函式 (p2p.h)

  • 發行項

PFNPEER_VALIDATE_RECORD回呼會指定對等圖形基礎結構呼叫以驗證記錄的函式。

語法

PFNPEER_VALIDATE_RECORD PfnpeerValidateRecord;

HRESULT PfnpeerValidateRecord(
  [in] HGRAPH hGraph,
  [in] PVOID pvContext,
  [in] PPEER_RECORD pRecord,
  [in] PEER_RECORD_CHANGE_TYPE changeType
)
{...}

參數

[in] hGraph

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

[in] pvContext

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

[in] pRecord

指定要驗證的記錄。

[in] changeType

指定驗證必須發生的原因。 必須是其中一個 PEER_RECORD_CHANGE_TYPE 值。

傳回值

如果此回呼成功，傳回值會S_OK;否則，函式會傳回下列其中一個錯誤：

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
PEER_E_DEFERRED_VALIDATION
 目前無法驗證指定的記錄，因為沒有足夠的資訊無法完成作業。 驗證會延遲。 取得足夠的資訊時，呼叫 PeerGraphValidateDeferredRecords 。
PEER_E_INVALID_RECORD
 指定的記錄無效。

備註

當對等圖形基礎結構呼叫此回呼時，會傳遞 PEER_RECORD_CHANGE_TYPE 值。 這會指定剛在記錄上執行的作業。 應用程式必須根據變更類型來驗證記錄。 如果應用程式需要更多資訊來驗證記錄，它可以傳回PEER_E_DEFERRED_VALIDATION，而對等圖形基礎結構會將記錄放在延後記錄清單中。 一旦安全性機制有足夠的資訊可以驗證記錄，它會呼叫 PeerGraphValidateDeferredRecords，而延後記錄清單中的任何記錄都會重新提交以進行驗證。

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

規格需求

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

另請參閱

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

PeerGraphValidateDeferredRecords