次の方法で共有

Store.Open メソッド

  • [アーティクル]

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

Open メソッドは、指定された証明書ストアを開きます。 既定では、CAPICOM_CURRENT_USER_STOREの場所とCAPICOM_MY_STOREストアは読み取り専用として開かれます。

構文

Store.Open( _
  [ ByVal StoreLocation ], _
  [ ByVal StoreName ], _
  [ ByVal OpenMode ] _
)

パラメーター

StoreLocation [in, optional]

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

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

 

StoreName [in, optional]

開くシステム証明書ストアの名前を含む文字列。 既定値は CAPICOM_MY_STORE です。 ストアが Web スクリプトから開かれている場合、名前に円記号 (\) 文字は使用できません。 システムによって定義されたストアに加えて、ユーザー定義ストアを開くことができます。

このパラメーターには、ユーザー定義ストアまたは次のいずれかのシステム証明書ストアを指定できます。

値 説明
CAPICOM_CA_STORE
 CA ストア。 このストアは、中間 CA 証明書を格納するために使用されます。
CAPICOM_MY_STORE
 マイ ストア。 このストアは、ユーザーの個人証明書に使用されます。
CAPICOM_OTHER_STORE
 AddressBook ストア。 このストアは、他のユーザーの証明書を保持するために使用されます。
CAPICOM_ROOT_STORE
 ルート ストア。 このストアは、ルート CA と自己署名の信頼された証明書を格納するために使用されます。

 

OpenMode [in, optional]

ストアの開いているモードを示す CAPICOM_STORE_OPEN_MODE 列挙の値。 既定値は CAPICOM_STORE_OPEN_READ_ONLY です。 ストアが Web スクリプトから開かれた場合、この値は強制的にCAPICOM_STORE_OPEN_EXISTING_ONLYされます。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
CAPICOM_STORE_OPEN_MAXIMUM_ALLOWED
 ユーザーが読み取り/書き込みアクセス許可を持っている場合は、読み取り/書き込みモードでストアを開きます。それ以外の場合は、読み取り専用モードでストアを開きます。
CAPICOM_STORE_OPEN_READ_ONLY
 ストアを読み取り専用モードで開きます。
CAPICOM_STORE_OPEN_READ_WRITE
 読み取り/書き込みモードでストアを開きます。

 

論理 OR 演算を使用して、次のフラグを前の表の値と組み合わせることができます。

値 説明
CAPICOM_STORE_OPEN_EXISTING_ONLY
 既存のストアのみを開きます。新しいストアを作成しないでください。 CAPICOM 2.0 で導入されました。
CAPICOM_STORE_OPEN_INCLUDE_ARCHIVED
 ストアを使用する場合は、アーカイブされた証明書を含めます。 CAPICOM 2.0 で導入されました。

 

一部の場所のストアは、読み取り専用モードでのみ開くことができます。 これには、ユーザーが書き込みアクセス許可を持たないCAPICOM_LOCAL_MACHINE_STORE内のすべてのストアが含まれます。 適切なアクセス権とアクセス許可なしでストアを読み取り/書き込みストアとして開こうとすると、 Open メソッドが失敗します。 Active Directory ストアは、Open メソッドの失敗なしに読み取り/書き込みストアとして 開 くことができますが、ストアに対する変更は保持されません。

戻り値

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

解説

このメソッドが SmartCard ストアで呼び出されると、追加の SmartCard ユーザー インターフェイスが呼び出される可能性があります。

重要

このメソッドが Web スクリプトから呼び出されると、スクリプトはローカル コンピューター上のデジタル証明書にアクセスする必要があります。 スクリプトでデジタル証明書へのアクセスを許可すると、スクリプトの実行元の Web サイトも、証明書に格納されている個人情報にアクセスできるようになります。 このメソッドが特定のドメインから初めて呼び出されると、ダイアログ ボックスが生成され、ユーザーは証明書へのアクセスを許可するかどうかを指定する必要があります。 Web スクリプトから開かれたストアでは、CAPICOM_STORE_OPEN_EXISTING_ONLY フラグが自動的に強制されます。

 

StoreLocation がCAPICOM_SMART_CARD_USER_STORE場合、StoreName は無視されます。 この場合、CAPICOM は、スマート カードを含むすべての使用可能なリーダーからすべての証明書を読み取ります。

必要条件

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

関連項目

ストア

Cryptography オブジェクト

閉じる