BCryptGetProperty

CNG オブジェクトの名前付きプロパティの値を取得する。

BCryptGetProperty hObject, pszProperty, pbOutput, cbOutput, pcbResult, dwFlags

hObject : [int] プロパティ値を取得する対象 CNG オブジェクトを表すハンドル。
pszProperty : [wstr] 取得するプロパティの名前を含む、null 終端 Unicode 文字列へのポインタ。事前定義された Cryptography Primitive Property 識別子のいずれか、またはカスタムプロパティ識別子を指定できる。
pbOutput : [var] プロパティ値を受け取るバッファのアドレス。cbOutput パラメータがこのバッファのサイズを示す。
cbOutput : [int] pbOutput バッファのバイト単位のサイズ。
pcbResult : [var] pbOutput バッファにコピーされたバイト数を受け取る ULONG 変数へのポインタ。pbOutput パラメータが NULL の場合、関数は必要なサイズをバイト単位で、このパラメータが指す位置に格納する。
dwFlags : [int] 関数の動作を変更するフラグの集合。この関数で定義されているフラグはない。

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

解説

CNG オブジェクトの名前付きプロパティの値を取得する。

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

[備考]
プロパティに必要なサイズを取得するには、pbOutput パラメータに NULL を渡す。関数は必要なサイズをバイト単位で
pcbResult パラメータが指す値に格納する。プロバイダがサポートするプロセッサモードに応じて、BCryptGetProperty
はユーザーモードまたはカーネルモードのいずれからでも呼び出せる。カーネルモードの呼び出し元は PASSIVE_LEVEL IRQL または
DISPATCH_LEVEL IRQL のいずれかで実行できる。現在の IRQL レベルが DISPATCH_LEVEL
である場合、BCryptGetProperty
関数に渡すポインタはページング不可（あるいはロックされた）メモリを参照しなければならない。hObject
パラメータに指定したオブジェクトがハンドルである場合、それは BCRYPT_PROV_DISPATCH
フラグを指定してオープンされたものでなければならない。この関数をカーネルモードで呼び出すには、Driver Development Kit
(DDK) に含まれる Cng.lib を使用する。Windows Server 2008 および Windows Vista:
この関数をカーネルモードで呼び出すには Ksecdd.lib を使用する。

情報