Win32 API 日本語リファレンス
ホーム › Security.Cryptography › BCryptCloseAlgorithmProviderFn

BCryptCloseAlgorithmProviderFn

コールバック

シグネチャ

NTSTATUS BCryptCloseAlgorithmProviderFn(
    BCRYPT_ALG_HANDLE hAlgorithm,
    DWORD dwFlags
);

パラメーター

フィールド型説明
hAlgorithmBCRYPT_ALG_HANDLE閉じるアルゴリズムプロバイダーを表すハンドルです。このハンドルは、BCryptOpenAlgorithmProvider 関数を呼び出して取得します。
dwFlagsDWORDこの関数の動作を変更するフラグのセットです。この関数に対して定義されているフラグはありません。

公式ドキュメント

BCryptCloseAlgorithmProvider 関数は、CNG アルゴリズムプロバイダーを閉じます。

メモ: Windows 10 以降を対象とする呼び出し元は、CNG アルゴリズムプロバイダーを開いたり閉じたりする代わりに、CNG Algorithm Pseudo-handles の使用を検討してください。制限事項については、CNG アルゴリズム疑似ハンドルのドキュメントの解説を参照してください。

戻り値

関数の成功または失敗を示すステータスコードを返します。

返される可能性のあるコードには、次のものが含まれます (ただし、これらに限定されません)。

戻り値 説明
STATUS_SUCCESS 関数は成功しました。
STATUS_INVALID_HANDLE hAlgorithm パラメーターで指定されたアルゴリズムハンドルが無効であるか、閉じることができない疑似ハンドルです。

解説(Remarks)

BCryptCloseAlgorithmProvider は、ユーザーモードとカーネルモードのどちらからでも呼び出すことができます。カーネルモードの呼び出し元は、PASSIVE_LEVEL IRQL で実行されている必要があります。

この関数をカーネルモードで呼び出すには、Driver Development Kit (DDK) に含まれる Cng.lib を使用します。Windows Server 2008 および Windows Vista: この関数をカーネルモードで呼び出すには、Ksecdd.lib を使用します。

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