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 簽署的檔案。

密碼 [in，選擇性]

字串，包含檔案的純文字密碼。最多 32 個 Unicode 字元，包括終止的 Null 字元，可用於密碼。如需保護密碼的相關資訊，請參閱處理密碼。

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 基礎密碼編譯提供者，且解密作業失敗，則應該使用 Microsoft 強式密碼編譯提供者或 Microsoft 增強式密碼編譯提供者再次嘗試解密作業，無論可用。

如果載入至存放區的憑證與已經存在的憑證相同， Load 方法會從存放區中刪除現有的憑證，然後新增憑證。新的憑證會繼承現有憑證的屬性。現有的私密金鑰容器會由新的私密金鑰容器取代。

需求	值
可轉散發套件	Windows Server 2003 和 Windows XP 上的 CAPICOM 2.0 或更新版本
DLL	Capicom.dll