ホーム › Security.Cryptography › PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE

コールバック

シグネチャ

void PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE(
    CRYPT_OBJECT_LOCATOR_RELEASE_REASON dwReason,
    void* pPluginContext
);

パラメーター

フィールド

型

説明

dwReason

CRYPT_OBJECT_LOCATOR_RELEASE_REASON

プロバイダーが解放される理由を指定します。次のいずれかの値を指定できます。

値	意味
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN 1	コンピューターがシャットダウンしています。
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP 2	サービスが停止しています。
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT 3	呼び出し元のプロセスが終了しようとしています。
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD 4	プロバイダー DLL がアンロードされています。

pPluginContext

void*

このプロバイダーが定義し、PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE 関数が返した、省略可能なバッファーへのポインター。このバッファーは呼び出し元によって変更されません。プロバイダーは、このデータを使用して実行する処理を判断したり、追加情報を保持したりできます。

公式ドキュメント

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE コールバック関数は、プロバイダーを解放します。

解説(Remarks)

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE コールバック関数は、現在のところ Secure Channel (Schannel) セキュリティパッケージからのみ呼び出されます。この関数は、PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE の呼び出しごとに 1 回呼び出されます。

プロバイダーはすべてのオブジェクトのメモリをすべて解放する必要はありませんが、dwReason パラメーターに CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP または CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD が設定されている場合は、自身のクリーンアップを行う必要があります。

この関数は、PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH の呼び出しが完了できるように、ブロックする必要があります。

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