BCryptHash

単一のハッシュ計算を行う。これは BCryptCreateHash、BCryptHashData、BCryptFinishHash、BCryptDestroyHash の呼び出しをラップする便利関数である。

BCryptHash hAlgorithm, pbSecret, cbSecret, pbInput, cbInput, pbOutput, cbOutput

hAlgorithm : [int] BCryptOpenAlgorithmProvider 関数を使用して作成されたアルゴリズムプロバイダのハンドル。プロバイダ作成時に指定されたアルゴリズムはハッシュインターフェイスをサポートしていなければならない。
pbSecret : [var] ハッシュまたは MAC に使用するキーを格納するバッファへのポインタ。cbSecret パラメータがこのバッファのサイズを示す。このキーは、BCryptOpenAlgorithmProvider 関数を BCRYPT_ALG_HANDLE_HMAC フラグを指定してオープンしたハッシュアルゴリズムにのみ適用される。それ以外の場合はこのパラメータを NULL に設定する。
cbSecret : [int] pbSecret バッファのバイト単位のサイズ。キーを使用しない場合はこのパラメータを 0 に設定する。
pbInput : [var] 処理対象のデータを格納するバッファへのポインタ。cbInput パラメータがこのバッファ内のバイト数を示す。この関数はこのバッファの内容を変更しない。
cbInput : [int] pbInput バッファ内のバイト数。
pbOutput : [var] ハッシュまたは MAC 値を受け取るバッファへのポインタ。cbOutput パラメータがこのバッファのサイズを示す。
cbOutput : [int] pbOutput バッファのバイト単位のサイズ。このサイズはハッシュまたは MAC 値のサイズと正確に一致しなければならない。サイズは BCryptGetProperty 関数を呼び出して BCRYPT_HASH_LENGTH プロパティを取得することで得られる。これは指定したアルゴリズムにおけるハッシュまたは MAC 値のサイズを返す。

(プラグイン / モジュール : bcrypt.dll)

解説

単一のハッシュ計算を行う。これは
BCryptCreateHash、BCryptHashData、BCryptFinishHash、BCryptDestroyHash
の呼び出しをラップする便利関数である。

[戻り値]
成否を示すステータスコード。

情報