BCryptQueryContextFunctionConfiguration

既存の CNG コンテキストの暗号関数構成情報を取得する。

BCryptQueryContextFunctionConfiguration dwTable, pszContext, dwInterface, pszFunction, pcbBuffer, ppBuffer

dwTable : [int] 
pszContext : [wstr] 関数構成情報を取得する対象コンテキストの識別子を含む、null 終端 Unicode 文字列へのポインタ。
dwInterface : [int] 
pszFunction : [wstr] 構成情報を取得する対象暗号関数の識別子を含む、null 終端 Unicode 文字列へのポインタ。
pcbBuffer : [var] ULONG 変数のアドレスで、入力時には ppBuffer が指すバッファのバイト単位のサイズを格納する。このサイズがコンテキスト情報を保持するのに十分でない場合、関数は STATUS_BUFFER_TOO_SMALL で失敗する。関数が戻った後、この変数には ppBuffer バッファにコピーされたバイト数が格納される。
ppBuffer : [var] この関数によって取得された関数構成情報を受け取る、CRYPT_CONTEXT_FUNCTION_CONFIG 構造体へのポインタのアドレス。pcbBuffer パラメータが指す値がこのバッファのサイズを示す。このパラメータが指す値が NULL の場合、関数は必要なメモリを確保する。このメモリは不要になったら、このポインタを BCryptFreeBuffer 関数に渡して解放しなければならない。このパラメータが NULL の場合、関数は必要なサイズをバイト単位で pcbBuffer パラメータが指す変数に格納し、STATUS_BUFFER_TOO_SMALL を返す。このパラメータの使い方の詳細は「備考」を参照。

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

解説

既存の CNG コンテキストの暗号関数構成情報を取得する。

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

[備考]
各暗号関数は構成情報の集合を 1 つしか持たないため、ppBuffer パラメータは配列のように見えるが、この関数は要素数 1
の配列として扱う。次の例はこのパラメータの使い方を明確にする助けになる。
（以下省略）

情報