CryptGetDefaultProviderW

ローカルコンピュータまたは現在のユーザーに対する、指定したプロバイダ種別の既定の暗号化サービスプロバイダ (CSP) を取得する。(Unicode)

CryptGetDefaultProviderW dwProvType, pdwReserved, dwFlags, pszProvName, pcbProvName

dwProvType : [int] 既定の CSP 名を見つけるプロバイダの種類。定義されているプロバイダの種類は以下のとおり。
pdwReserved : [var] このパラメータは将来の使用のために予約されており、NULL でなければならない。
dwFlags : [int] 以下のフラグ値が定義されている。
pszProvName : [wstr] 既定の CSP の名前を受け取る null 終端文字列バッファへのポインタ。メモリ確保のためにバッファのサイズを取得する目的で、このパラメータは NULL にできる。詳細は Retrieving Data of Unknown Length を参照。
pcbProvName : [var] pszProvName パラメータが指すバッファのサイズ (バイト単位) を指定する DWORD 値へのポインタ。関数が戻るとき、DWORD 値にはバッファに格納された、または格納されるバイト数が含まれる。注: バッファに返されたデータを処理する際、アプリケーションは返されたデータの実際のサイズを使用しなければならない。実際のサイズは入力時に指定したバッファサイズよりわずかに小さい可能性がある (入力時には通常、想定される最大出力データが収まるようバッファサイズを大きめに指定するためである)。出力時、このパラメータが指す変数はバッファにコピーされたデータの実際のサイズを反映するように更新される。

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

解説

ローカルコンピュータまたは現在のユーザーに対する、指定したプロバイダ種別の既定の暗号化サービスプロバイダ (CSP)
を取得する。(Unicode)

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

[備考]
この関数は、ローカルコンピュータまたは現在のユーザーに対して現在既定として設定されているインストール済み CSP
を判別する。この情報はユーザーに表示されることが多い。

情報