Store.Load メソッド

[ Load メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 代わりに、System.Security.Cryptography.X509Certificates 名前空間で X509Storeクラスを使用します。

Load メソッドは、ファイルからストアに証明書をインポートします。

構文

Store.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ] _
)

パラメーター

FileName [in]

.cer、.sst、.spc、.p7s、または .pfx ファイル、または Authenticode 署名済みファイルへのパスを含む文字列。

パスワード [入力、省略可能]

ファイルのプレーンテキスト パスワードを含む文字列。 パスワードには、終端の null 文字を含め、最大 32 文字の Unicode 文字を使用できます。 パスワードの保護については、「パスワードの 処理」を参照してください。

KeyStorageFlag [in, optional]

キー ストレージ フラグを定義する CAPICOM_KEY_STORAGE_FLAG 列挙の値。 既定値は CAPICOM_KEY_STORAGE_DEFAULT です。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
CAPICOM_KEY_STORAGE_DEFAULT
 既定のキー ストレージ。
CAPICOM_KEY_STORAGE_EXPORTABLE
 キーはエクスポート可能です。
CAPICOM_KEY_STORAGE_USER_PROTECTED
 キーはユーザー保護です。

 

戻り値

このメソッドは値を返しません。

解説

メモリ ストアで Load メソッドが呼び出された場合、作成されたキー コンテナーは、メモリ ストアの削除時に削除されます。 たとえば、.pfx ファイルがメモリ ストアに読み込まれ、後でメモリ ストアからシステム ストア (マイ ストアなど) に追加された場合、My ストア内の証明書にはキーは含まれません。 この場合、.pfx ファイルをマイ ストアに直接読み込む必要があります。

このメソッドは、Web ベースのアプリケーションからスクリプト化されるときにCAPICOM_E_NOT_ALLOWEDを発生させます。

パスワードが秘密キー ファイルの暗号化解除に失敗した場合は、既定の 暗号化サービス プロバイダー (CSP) のクエリを実行する必要があります。 既定の CSP が Microsoft Base Cryptographic Provider で、暗号化解除操作が失敗した場合は、Microsoft Strong Cryptographic Provider または Microsoft Enhanced Cryptographic Provider (使用可能な方) で暗号化解除操作を再試行する必要があります。

ストアに読み込まれる証明書が既にある証明書と同じ場合、 Load メソッドはストアから既存の証明書を削除し、新しい証明書を追加します。 新しい証明書は、既存の証明書からプロパティを継承します。 既存の秘密キー コンテナーは、新しい秘密キー コンテナーに置き換えられます。

必要条件

要件 値
再頒布可能パッケージ
 Windows Server 2003 および Windows XP の CAPICOM 2.0 以降
[DLL]
Capicom.dll

関連項目

ストア

 

 

  • 最終更新: