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 値」を参照してください。

リターン コード/値	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

注釈

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

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• 名前
• 有効
• Version

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	certenroll.h
[DLL]	CertEnroll.dll

こちらもご覧ください

ICspInformation