CryptSetHashParam 関数 (wincrypt.h)

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

CryptSetHashParam 関数は、初期ハッシュコンテンツの設定や特定のハッシュアルゴリズムの選択など、ハッシュオブジェクトの操作をカスタマイズします。

構文

BOOL CryptSetHashParam(
  [in] HCRYPTHASH hHash,
  [in] DWORD      dwParam,
  [in] const BYTE *pbData,
  [in] DWORD      dwFlags
);

[in] hHash

パラメーターを設定するハッシュオブジェクトへのハンドル。

[in] dwParam

このパラメーターには、次の値のいずれかを指定できます。

値	意味
HP_HMAC_INFO。	暗号化ハッシュアルゴリズムと、使用する内部文字列と外部文字列を指定する HMAC_INFO構造体へのポインター。
HP_HASHVAL。	ハッシュオブジェクトに直接配置するハッシュ値を含むバイト配列。この値を設定する前に、 CryptGetHashParam 関数を使用してHP_HASHSIZE値を読み取ることによって、ハッシュ値のサイズを決定する必要があります。一部の暗号化サービスプロバイダー (CSP) では、この機能がサポートされていません。

メモ一部の CSP の種類では、この関数を使用して設定できる値を追加できます。

[in] pbData

値データバッファー。 CryptSetHashParam を呼び出す前に、このバッファーに値データを配置します。このデータの形式は、値番号によって異なります。

[in] dwFlags

このパラメーターは将来使用するために予約されており、0 に設定する必要があります。

関数が成功した場合、関数は TRUE を返します。

関数が失敗すると、 FALSE が返されます。拡張エラー情報については、 GetLastError を呼び出します。

"NTE" の前に表示されるエラーコードは、使用している特定の CSP によって生成されます。考えられるエラーコードの一部を次に示します。

リターンコード	説明
ERROR_INVALID_HANDLE	パラメーターの 1 つは、無効なハンドルを指定します。
ERROR_BUSY	現在、CSP コンテキストは別のプロセスで使用されています。
ERROR_INVALID_PARAMETER	パラメーターの 1 つに無効な値が含まれています。これは、ほとんどの場合、無効なポインターです。
NTE_BAD_FLAGS	dwFlags パラメーターが 0 以外であるか、pbData バッファーに無効な値が含まれています。
NTE_BAD_HASH	hHash パラメーターで指定されたハッシュオブジェクトが無効です。
NTE_BAD_TYPE	dwParam パラメーターは、不明な値を指定します。
NTE_BAD_UID	hKey キーの作成時に指定された CSP コンテキストが見つかりません。
NTE_FAIL	関数が予期しない方法で失敗しました。

場合によっては、他の場所で生成されたハッシュ値に署名する必要があります。これは、次の一連の操作を使用して行うことができます。