CryptSetKeyParam

セッション鍵の動作のさまざまな側面をカスタマイズする。

CryptSetKeyParam hKey, dwParam, pbData, dwFlags

hKey : [int] 値を設定する鍵へのハンドル。
dwParam : [int] 以下の表に、使用できる事前定義値を示す。
pbData : [var] CryptSetKeyParam を呼び出す前に設定する値で初期化されたバッファへのポインタ。このデータの形式は dwParam の値によって異なる。
dwFlags : [int] dwParam が KP_ALGID のときにのみ使用される。dwFlags パラメータは有効化される鍵のフラグ値を渡すために使用される。dwFlags パラメータは、鍵サイズや、CryptGenKey で同じ種類の鍵を生成するときに許可される他のフラグ値などを保持できる。指定可能なフラグ値については CryptGenKey を参照。

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

解説

セッション鍵の動作のさまざまな側面をカスタマイズする。

[戻り値]
関数が成功した場合、戻り値はゼロ以外 (TRUE) となる。失敗した場合、戻り値はゼロ (FALSE)
となる。拡張エラー情報を取得するには GetLastError を呼び出す。「NTE」で始まるエラーコードは使用中の特定の CSP
が生成する。以下のエラーコードが返される可能性がある。
（以下省略）

[備考]
KP_Q、KP_P、または KP_X パラメータを PREGEN Diffie-Hellman または DSS
鍵に設定する場合、鍵の長さは、鍵が CryptGenKey で作成されたときに dwFlags パラメータの上位 16
ビットを使って設定した鍵長と互換である必要がある。CryptGenKey
で鍵長が設定されていなかった場合、既定の鍵長が使用されていた。P、Q、X を設定するために既定以外の鍵長が使用されると、エラーとなる。

情報