CryptSetProvParam

暗号化サービスプロバイダ (CSP) の動作をカスタマイズする。この関数は、CSP に関連付けられたキーコンテナにセキュリティ記述子を設定して、そのキーコンテナ内の秘密鍵へのアクセスを制御するためによく使用される。

CryptSetProvParam hProv, dwParam, pbData, dwFlags

hProv : [int] 値を設定する CSP のハンドル。このハンドルは CryptAcquireContext 関数を使用して既に作成されていなければならない。
dwParam : [int] 
pbData : [var] プロバイダパラメータとして設定する値を格納するデータバッファへのポインタ。このデータの形式は dwParam の値によって異なる。dwParam が PP_USE_HARDWARE_RNG を含む場合、このパラメータは NULL でなければならない。
dwFlags : [int] dwParam が PP_KEYSET_SEC_DESCR を含む場合、dwFlags には Platform SDK で定義された SECURITY_INFORMATION の該当するビット フラグが入る。キーコンテナのセキュリティは SetFileSecurity と GetFileSecurity を使って処理される。これらのビット フラグはビット単位の OR 演算で組み合わせることができる。詳細は CryptGetProvParam を参照。dwParam が PP_USE_HARDWARE_RNG または PP_DELETEKEY の場合、dwFlags はゼロに設定しなければならない。

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

解説

暗号化サービスプロバイダ (CSP) の動作をカスタマイズする。この関数は、CSP
に関連付けられたキーコンテナにセキュリティ記述子を設定して、そのキーコンテナ内の秘密鍵へのアクセスを制御するためによく使用される。

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

情報