BCryptDeriveKey

秘密合意値からキーを導出する。 (BCryptDeriveKey)

BCryptDeriveKey hSharedSecret, pwszKDF, pParameterList, pbDerivedKey, cbDerivedKey, pcbResult, dwFlags

hSharedSecret : [int] キーを作成するための秘密合意ハンドル。このハンドルは BCryptSecretAgreement 関数から取得する。
pwszKDF : [wstr] キーを導出するために使用するキー導出関数 (KDF) を識別する、null 終端 Unicode 文字列へのポインタ。次の文字列のいずれかを指定できる。
pParameterList : [var] KDF パラメータを格納した BCryptBufferDesc 構造体のアドレス。このパラメータは省略可能で、不要な場合は NULL を指定できる。
pbDerivedKey : [var] キーを受け取るバッファのアドレス。cbDerivedKey パラメータがこのバッファのサイズを示す。このパラメータが NULL の場合、関数は必要なサイズをバイト単位で pcbResult が指す ULONG に格納する。
cbDerivedKey : [int] pbDerivedKey バッファのバイト単位のサイズ。
pcbResult : [var] pbDerivedKey バッファにコピーされたバイト数を受け取る ULONG へのポインタ。pbDerivedKey が NULL の場合、関数は必要なサイズをバイト単位で、このパラメータが指す ULONG に格納する。
dwFlags : [int] 関数の動作を変更するフラグの集合。0 または次の値を指定できる。

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

解説

秘密合意値からキーを導出する。 (BCryptDeriveKey)

[戻り値]
関数の成否を示すステータスコードを返す。
返される可能性のあるコードには次のものが含まれるが、これらに限られない。
（以下省略）

[備考]
pParameterList パラメータの BCryptBufferDesc 構造体には、KDF_SECRET_PREPEND および
KDF_SECRET_APPEND パラメータを複数含めることができる。これらのパラメータが複数指定された場合、KDF
が呼び出される前に、配列内に格納された順序で値が連結される。たとえば、次のパラメータ値が指定されたと想定する。
（以下省略）

情報