CryptDestroyHash 関数 (wincrypt.h)

大事な この API は非推奨です。新規および既存のソフトウェアでは、暗号化次世代 API の使用を開始する必要があります。Microsoft は、今後のリリースでこの API を削除する可能性があります。

CryptDestroyHash 関数は、hHash パラメーターによって参照されるハッシュオブジェクトを破棄します。ハッシュオブジェクトが破棄された後は、使用できなくなります。

セキュリティを確保するために、ハッシュオブジェクトを使用した後に破棄することをお勧めします。

構文

BOOL CryptDestroyHash(
  [in] HCRYPTHASH hHash
);

[in] hHash

破棄されるハッシュオブジェクトのハンドル。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。拡張エラー情報については、 GetLastError を呼び出します。

"NTE" の前に表示されるエラーコードは、使用している特定の暗号化サービスプロバイダー (CSP) によって生成されます。考えられるエラーコードの一部を次に示します。

リターンコード	説明
ERROR_BUSY	hHash で指定されたハッシュオブジェクトは現在使用されており、破棄できません。
ERROR_INVALID_HANDLE	hHash パラメーターは、無効なハンドルを指定します。
ERROR_INVALID_PARAMETER	hHash パラメーターに無効な値が含まれています。
NTE_BAD_ALGID	hHash ハンドルは、この CSP でサポートされていないアルゴリズムを指定します。
NTE_BAD_HASH	hHash パラメーターで指定されたハッシュオブジェクトが無効です。
NTE_BAD_UID	ハッシュオブジェクトの作成時に指定された CSP コンテキストが見つかりません。

ハッシュオブジェクトが破棄されると、多くの CSP によって、ハッシュオブジェクトが保持されていた CSP 内のメモリが上書きされます。その後、CSP メモリが解放されます。

CryptCreateHash と CryptDestroyHash の呼び出しの間には、1 対 1 の対応が必要です。

特定の CSP を使用して作成されたすべてのハッシュオブジェクトは、その CSP ハンドルが CryptReleaseContext 関数で解放される前に破棄する必要があります。

CryptDestroyHash 関数を使用する例については、「C プログラムの例: セッションキーの作成とハッシュ」を参照してください。