PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE コールバック関数 (wincrypt.h)

  • [アーティクル]

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

構文

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

void PfnCryptObjectLocatorProviderRelease(
  [in]           DWORD dwReason,
  [in, optional] LPVOID pPluginContext
)
{...}

パラメーター

[in] dwReason

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

値 意味
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 がアンロード中です。

[in, optional] pPluginContext

このプロバイダーによって定義され、 PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE 関数によって返される省略可能なバッファーへのポインター。 バッファーは呼び出し元によって変更されません。 プロバイダーは、データを使用して、実行するアクションを決定したり、追加情報を維持したりするのに役立ちます。

戻り値

なし

解説

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 の呼び出しを完了できるようにブロックする必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wincrypt.h

こちらもご覧ください

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE