ICspInformation::InitializeFromType メソッド (certenroll.h)

InitializeFromType メソッドは、既定の暗号化プロバイダーからオブジェクトを初期化します。

構文

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

パラメーター

[in] Type

プロバイダーの種類を定義する X509ProviderType 列挙値。

• XCN_PROV_NONE指定し、 pAlgorithm パラメーターを NULL 以外の値に設定すると、既定の Cryptography API: Next Generation (CNG) プロバイダーが使用されます。
• XCN_PROV_NONE以外の値を指定し、 pAlgorithm パラメーターを NULL に設定すると、既定のレガシ暗号化サービス プロバイダー (CSP) が使用されます。

[in, optional] pAlgorithm

アルゴリズム OID を表す IObjectId インターフェイスへのポインター。 このパラメーターは省略可能であり、NULL できます。 詳細については、 Type パラメーターを参照してください。

[in] MachineContext

コンピューター または ユーザー コンテキストを使用して、指定したプロバイダーの種類の既定のプロバイダーを決定するかどうかを示すVARIANT_BOOL変数。 コンピューター のVARIANT_TRUE とユーザーの VARIANT_FALSE を指定します。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

注釈

InitializeFromType メソッドは、指定した型を検証して Type プロパティに保存し、既定のプロバイダーを取得し、ICspInformation オブジェクトに次のプロパティ値を設定します。

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• 名前
• Valid
• バージョン

このメソッドは、CspAlgorithms プロパティによって返される ICspAlgorithms コレクションに使用可能なアルゴリズムを追加します。 InitializeFromName メソッドを呼び出して、CSP 名からオブジェクトを初期化します。

Requirements

こちらも参照ください

ICspInformation