CryptGetKeyParam

鍵の動作を制御するデータを取得する。

CryptGetKeyParam hKey, dwParam, pbData, pdwDataLen, dwFlags

hKey : [int] クエリ対象の鍵のハンドル。
dwParam : [int] 実行するクエリの種類を指定する。
pbData : [var] データを受け取るバッファへのポインタ。このデータの形式は dwParam の値によって異なる。このバッファのサイズが不明な場合、このパラメータに NULL を渡し、pdwDataLen が指す値をゼロに設定することで、実行時に必要なサイズを取得できる。この関数は pdwDataLen が指す値に、必要なバッファサイズ (バイト単位) を格納する。詳細は Retrieving Data of Unknown Length を参照。
pdwDataLen : [var] DWORD 値へのポインタ。入力時には pbData パラメータが指すバッファのサイズ (バイト単位) を含む。関数が戻ると、この値にはバッファに格納されたバイト数が含まれる。注: バッファに返されたデータを処理する際、アプリケーションは返されたデータの実際のサイズを使用しなければならない。実際のサイズは入力時に指定したバッファサイズよりわずかに小さい可能性がある。入力時には、想定される最大出力データが収まるようバッファサイズを大きめに指定することがある。出力時、このパラメータが指す変数はバッファにコピーされたデータの実際のサイズを反映するように更新される。
dwFlags : [int] このパラメータは将来の使用のために予約されており、ゼロに設定しなければならない。

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

解説

鍵の動作を制御するデータを取得する。

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

情報