ホーム › Security.Cryptography › PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH

コールバック

シグネチャ

BOOL PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH(
    void* pContext,
    CRYPT_INTEGER_BLOB** rgIdentifierOrNameList,
    DWORD dwIdentifierOrNameListCount
);

パラメーター

フィールド	型	説明
pContext	void*	このプロバイダーに関する情報を格納する、プロバイダー定義のオブジェクトへのポインターです。
rgIdentifierOrNameList	CRYPT_INTEGER_BLOB**	名前または識別子の配列へのポインターです。
dwIdentifierOrNameListCount	DWORD	rgIdentifierOrNameList パラメーターで指定された名前または識別子の数です。

公式ドキュメント

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH コールバック関数は、オブジェクトが変更されたことを指定します。プロバイダーは、特定の名前または識別子が更新されたと判断したときに、この関数を呼び出します。

戻り値

関数が成功した場合は、0 以外の値 (TRUE) を返します。

関数が失敗した場合は、0 (FALSE) を返します。

解説(Remarks)

プロバイダーは、オブジェクトが変更されたことを示すために、PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH コールバック関数の実装を呼び出します。

この関数へのポインターは、PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE 関数の pfnFlush パラメーターに設定されます。

識別子とは、呼び出し元のために検索されるオブジェクトを表すものとしてプロバイダーが選択したデータです。識別子は一意である必要はありません。識別子に関連付けられたオブジェクトが有効でなくなったとプロバイダーが判断した場合は、この関数を呼び出して、その識別子に関連付けられたすべてのオブジェクトを無効としてマークする必要があります。この関数はスレッドセーフです。

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