閱讀英文

共用方式為


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 使用者介面。

重要

從 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

另請參閱

商店

密碼編譯物件

關閉