ホーム › NetworkManagement.P2P › PFNPEER_SECURE_RECORD

PFNPEER_SECURE_RECORD

コールバック

シグネチャ

HRESULT PFNPEER_SECURE_RECORD(
    void* hGraph,
    void* pvContext,
    PEER_RECORD* pRecord,
    PEER_RECORD_CHANGE_TYPE changeType,
    PEER_DATA** ppSecurityData
);

パラメーター

フィールド	型	説明
hGraph	void*	指定されたレコードに関連付けられたピアグラフを指定します。
pvContext	void*	セキュリティコンテキストへのポインターです。このパラメーターは、PEER_SECURITY_INTERFACE 構造体の pvContext メンバーを指します。
pRecord	PEER_RECORD*	セキュリティ保護するレコードへのポインターです。
changeType	PEER_RECORD_CHANGE_TYPE	検証を行う理由を指定します。有効な値は PEER_RECORD_CHANGE_TYPE に列挙されています。
ppSecurityData	PEER_DATA**	このレコードのセキュリティデータを指定します。このデータは、コピーされてレコードに追加された後、PEER_SECURITY_INTERFACE の pfnFreeSecurityData メンバーで指定されたメソッドを呼び出すことで解放されます。

公式ドキュメント

PFNPEER_SECURE_RECORD コールバックは、レコードをセキュリティ保護するために Peer Graphing Infrastructure が呼び出す関数を指定します。

戻り値

このコールバックが成功した場合、戻り値は S_OK です。

解説(Remarks)

このコールバックは、アプリケーションが PeerGraphAddRecord や PeerGraphUpdateRecord など、レコードを変更するメソッドを呼び出すたびに呼び出されます。このコールバックでは、
小さなデジタル署名など、このレコードに固有のデータを作成し、ppSecurityData パラメーターを通じて返す必要があります。このデータはその後、レコードの securityData メンバーに追加され、PEER_SECURITY_INTERFACE の pfnValidateRecord メンバーで指定されたメソッドによって検証されます。

Note この処理は、ローカルコンピューターだけでなく、グラフに接続されているピアがレコードを受信したときにも、そのピア上で行われます。

changeType パラメーターで指定された操作が許可されていない場合、コールバックは S_OK ではなく、PEER_E_NOT_AUTHORIZED などの失敗コードを返す必要があります。

このコールバックは、PeerGraphUpdateRecord など、レコードに関係する任意の Peer Graphing API 関数から呼び出される可能性があります。

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