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

BCryptDestroyHashFn

コールバック

シグネチャ

NTSTATUS BCryptDestroyHashFn(
    BCRYPT_HASH_HANDLE hHash
);

パラメーター

フィールド型説明
hHashBCRYPT_HASH_HANDLE破棄するハッシュまたは MAC オブジェクトのハンドルです。このハンドルは、BCryptCreateHash 関数を使用して取得します。

公式ドキュメント

BCryptDestroyHash 関数は、ハッシュまたは メッセージ認証コード (MAC) オブジェクトを破棄します。

戻り値

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

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

戻り値 説明
STATUS_SUCCESS 関数は成功しました。
STATUS_INVALID_HANDLE hHash パラメーターのアルゴリズム ハンドルが有効ではありません。

解説(Remarks)

サポートされているアルゴリズム プロバイダーを使用する場合、BCryptDestroyHash はユーザー モードとカーネル モードのどちらからでも呼び出すことができます。カーネル モードの呼び出し元は、PASSIVE_LEVEL IRQL または DISPATCH_LEVEL IRQL のいずれかで実行できます。現在の IRQL レベルが DISPATCH_LEVEL の場合、hHash パラメーターに指定するハンドルは、BCRYPT_PROV_DISPATCH フラグを使用して開かれたプロバイダーが返したアルゴリズム ハンドルから派生したものである必要があります。

この関数をカーネル モードで呼び出すには、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)