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] |
|
関連項目