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， 選擇性]

指出存放區開啟模式 的 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 使用者介面。

如果 StoreLocation是CAPICOM_SMART_CARD_USER_STORE， 則會忽略 StoreName 。 在此情況下，CAPICOM 會從包含智慧卡的所有可用讀取器讀取所有憑證。

規格需求

另請參閱

商店

密碼編譯物件

關閉