Win32 API 日本語リファレンス
ホーム › NetworkManagement.P2P › PFNPEER_VALIDATE_RECORD

PFNPEER_VALIDATE_RECORD

コールバック

シグネチャ

HRESULT PFNPEER_VALIDATE_RECORD(
    void* hGraph,
    void* pvContext,
    PEER_RECORD* pRecord,
    PEER_RECORD_CHANGE_TYPE changeType
);

パラメーター

フィールド型説明
hGraphvoid*指定されたレコードに関連付けられているピアグラフを指定します。
pvContextvoid*セキュリティコンテキストへのポインターです。このパラメーターは、PEER_SECURITY_INTERFACE 構造体の pvContext メンバーを指している必要があります。
pRecordPEER_RECORD*検証するレコードを指定します。
changeTypePEER_RECORD_CHANGE_TYPE検証を行う必要がある理由を指定します。PEER_RECORD_CHANGE_TYPE の値のいずれかである必要があります。

公式ドキュメント

PFNPEER_VALIDATE_RECORD コールバックは、Peer Graphing Infrastructure がレコードを検証するために呼び出す関数を指定します。

戻り値

このコールバックが成功した場合、戻り値は S_OK です。それ以外の場合は、次のいずれかのエラーを返します。

戻り値 説明
E_INVALIDARG
 パラメーターのいずれかが無効です。
PEER_E_DEFERRED_VALIDATION
 操作を完了するための情報が不足しているため、指定されたレコードを現時点では検証できません。検証は延期されます。十分な情報が得られた時点で PeerGraphValidateDeferredRecords を呼び出してください。
PEER_E_INVALID_RECORD
 指定されたレコードが無効です。

解説(Remarks)

このコールバックが Peer Graphing Infrastructure によって呼び出されるとき、PEER_RECORD_CHANGE_TYPE の値が渡されます。これは、そのレコードに対して直前に実行された操作を示します。アプリケーションは、この変更の種類に基づいてレコードを検証する必要があります。レコードの検証にさらに情報が必要な場合、アプリケーションは PEER_E_DEFERRED_VALIDATION を返すことができ、その場合 Peer Graphing Infrastructure はそのレコードを検証延期レコードの一覧に格納します。セキュリティ機構がレコードを検証するのに十分な情報を得ると、PeerGraphValidateDeferredRecords が呼び出され、検証延期レコードの一覧にあるレコードが再度検証に送られます。

このコールバックは、PeerGraphUpdateRecord など、レコードを扱う Peer Graphing API 関数のいずれからでも呼び出される可能性があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)