PrivateKey.Open メソッド

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

Open メソッドは、既存のキー コンテナーにアクセスします。 このメソッドは、指定した情報を使用して CERT_KEY_PROV_INFO_PROP_ID プロパティを追加することで、秘密キーに対応する証明書にキー コンテナーを関連付けます。

構文

PrivateKey.Open( _
  ByVal ContainerName, _
  [ ByVal ProviderName ], _
  [ ByVal ProviderType ], _
  [ ByVal KeySpec ], _
  [ ByVal StoreLocation ], _
  [ ByVal bCheckExistence ] _
)

パラメーター

ContainerName [in]

キー コンテナーの名前を含む文字列。

ProviderName [in, optional]

プロバイダーの名前を含む文字列。 既定値は CAPICOM_PROV_MS_ENHANCED_PROV です。 このパラメーターには、次の値のいずれかを指定できます。

値	説明
CAPICOM_PROV_MS_DEF_PROV	Microsoft ベースの暗号化プロバイダー。
CAPICOM_PROV_MS_ENHANCED_PROV	Microsoft 拡張暗号化プロバイダー。
CAPICOM_PROV_MS_STRONG_PROV	Microsoft の強力な暗号化プロバイダー。
CAPICOM_PROV_MS_DEF_RSA_SIG_PROV	Microsoft RSA 署名暗号化プロバイダー。
CAPICOM_PROV_MS_DEF_RSA_SCHANNEL_PROV	Microsoft RSA Schannel 暗号化プロバイダー。
CAPICOM_PROV_MS_DEF_DSS_PROV	Microsoft ベースの DSS 暗号化プロバイダー。
CAPICOM_PROV_MS_DEF_DSS_DH_PROV	Microsoft ベースの DSS とDiffie-Hellman暗号化プロバイダー。
CAPICOM_PROV_MS_ENH_DSS_DH_PROV	Microsoft の強化された DSS およびDiffie-Hellman暗号化プロバイダー。
CAPICOM_PROV_MS_DEF_DH_SCHANNEL_PROV	Microsoft DH Schannel 暗号化プロバイダー。
CAPICOM_PROV_MS_SCARD_PROV	Microsoft ベースのスマート カード暗号化プロバイダー。
CAPICOM_PROV_MS_ENH_RSA_AES_PROV	Microsoft 拡張 RSA および AES 暗号化プロバイダー。

 

ProviderType [in, optional]

プロバイダーの種類を指定する CAPICOM_PROV_TYPE 列挙体の値。 既定値は CAPICOM_PROV_RSA_FULL です。 このパラメーターには、次の値のいずれかを指定できます。

値	説明
CAPICOM_PROV_RSA_FULL	完全な RSA暗号化サービス プロバイダー (CSP)。 このプロバイダーの種類では、 デジタル署名 とデータ 暗号化の両方がサポートされています。
CAPICOM_PROV_RSA_SIG	ハッシュとデジタル署名に必要な関数とアルゴリズムのみをサポートする RSA CSP のサブセット。
CAPICOM_PROV_DSS	デジタル署名標準 (DSS) CSP。 このプロバイダーの種類では、ハッシュとデジタル署名のみがサポートされます。 DSS では、 デジタル署名アルゴリズム (DSA) が使用されます。
CAPICOM_PROV_FORTEZZA	米国国立標準技術研究所 (NIST) が所有する暗号化プロトコルとアルゴリズムを含む CSP。
CAPICOM_PROV_MS_EXCHANGE	Microsoft Exchange メール アプリケーションと Microsoft Mail と互換性のある他のアプリケーションをサポートする CSP。
CAPICOM_PROV_SSL	Secure Sockets Layer (SSL) プロトコルをサポートする CSP。
CAPICOM_PROV_RSA_SCHANNEL	RSA プロトコルと Schannel プロトコルの両方をサポートする CSP。
CAPICOM_PROV_DSS_DH	DSS プロトコルと Diffie-Hellman プロトコルの両方をサポートする CSP。
CAPICOM_PROV_EC_ECDSA_SIG	デジタル署名に必要な楕円曲線デジタル署名アルゴリズム (ECDSA) 関数とアルゴリズムをサポートする CSP。
CAPICOM_PROV_EC_ECNRA_SIG	デジタル署名に必要な楕円曲線Nyberg-Rueppelアナログ (ECNRA) 関数とアルゴリズムをサポートする CSP。
CAPICOM_PROV_EC_ECDSA_FULL	完全な ECDSA をサポートする CSP。
CAPICOM_PROV_EC_ECNRA_FULL	完全な ECNRA をサポートする CSP。
CAPICOM_PROV_DH_SCHANNEL	Diffie-Hellman プロトコルと Schannel プロトコルの両方をサポートする CSP。
CAPICOM_PROV_SPYRUS_LYNKS	SPYRUS LYNKS Card デバイスをサポートする CSP。
CAPICOM_PROV_RNG	乱数の生成を処理する CSP。
CAPICOM_PROV_INTEL_SEC	Intel セキュリティを提供する CSP。
CAPICOM_PROV_REPLACE_OWF	パスワードから一方向の形式を生成する方法の置き換えをサポートする CSP。
CAPICOM_PROV_RSA_AES	Advanced Encryption Standard (AES) アルゴリズムを使用したデジタル署名とデータ暗号化の両方をサポートする CSP。

 

KeySpec [in, optional]

秘密キーの種類を指定する CAPICOM_KEY_SPEC 列挙の値。 既定値は CAPICOM_KEY_SPEC_SIGNATURE です。 このパラメーターには、次の値のいずれかを指定できます。

値	説明
CAPICOM_KEY_SPEC_KEYEXCHANGE	キーは、暗号化と署名に使用できます。
CAPICOM_KEY_SPEC_SIGNATURE	キーは署名にのみ使用できます。

 

StoreLocation [in, optional]

キーが存在するストアの場所を指定する CAPICOM_STORE_LOCATION 列挙の値。 既定値は CAPICOM_CURRENT_USER_STORE です。 このパラメーターには、次の値のいずれかを指定できます。

値	説明
CAPICOM_MEMORY_STORE	ストアはメモリ ストアです。 ストアの内容の変更は保持されません。
CAPICOM_LOCAL_MACHINE_STORE	ストアはローカル コンピューター ストアです。 ローカル コンピューター ストアは、ユーザーが読み取り/書き込みアクセス許可を持っている場合にのみ、読み取り/書き込みストアにすることができます。 ユーザーに読み取り/書き込みアクセス許可があり、ストアが読み取り/書き込みで開かれている場合、ストアの内容の変更は保持されます。
CAPICOM_CURRENT_USER_STORE	ストアは現在のユーザー ストアです。 現在のユーザー ストアは、読み取り/書き込みストアである可能性があります。 その場合、ストアの内容の変更は保持されます。
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	ストアは Active Directory ストアです。 Active Directory ストアは、読み取り専用モードでのみ開くことができます。 証明書を Active Directory ストアに追加したり、Active Directory ストアから削除したりすることはできません。
CAPICOM_SMART_CARD_USER_STORE	ストアは、現在のスマート カードのグループです。 CAPICOM 2.0 で導入されました。

 

bCheckExistence [in, optional]

CAPICOM がキーへのアクセスを試みるかどうかを示すブール値。 True の場合、CAPICOM はキーへのアクセスを試みます。 キーがユーザーによって保護されているか、スマート カードまたはその他のデバイス上にある場合は、ダイアログ ボックスが生成される場合があります。 既定値は Falseです。

戻り値

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

解説

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

必要条件

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

関連項目

PrivateKey

Certificate.HasPrivateKey