ICertSrvSetup：：CAImportPFX 方法 (casetup.h)

  • 發行項

CAImportPFX 方法會將證書頒發機構單位 (CA) 憑證及其相關聯的私鑰匯入本機電腦存放區。 這個方法不會變更 CCertSrvSetup 物件的狀態。

語法

HRESULT CAImportPFX(
  [in]  const BSTR                  bstrFileName,
  [in]  const BSTR                  bstrPasswd,
  [in]  VARIANT_BOOL                bOverwriteExistingKey,
  [out] ICertSrvSetupKeyInformation **ppVal
);

參數

[in] bstrFileName

字串，包含用來匯入 私鑰的 PFX 檔名。

[in] bstrPasswd

包含 PFX 檔案密碼的字串。

[in] bOverwriteExistingKey

值，指出是否要覆寫相同名稱的現有索引鍵。

[out] ppVal

ICertSrvSetupKeyInformation 介面的指標位址，可用來設定匯入私鑰的屬性。

傳回值

無

備註

CAImportPFX 方法會使用輸入參數來解密和譯碼 PFX 檔案，然後在本機計算機存放區中安裝密鑰和憑證。 如果憑證符合下列準則，而且在安裝密鑰之後，此方法會將 ICertSrvSetupKeyInformation 物件傳回給呼叫端。

  • 包含符合私鑰容器中金鑰的AT_SIGNATURE金鑰。
  • 自我簽署或具有 CA 的基本條件約束。
  • 通過鏈結驗證，但可能會發生脫機撤銷錯誤。
如果 PFX 檔案包含多個憑證和金鑰， CAImportPFX 會安裝所有憑證和密鑰;不過，傳回的 ICertSrvSetupKeyInformation 物件只包含檔案中最後一個 CA 憑證的屬性。 當呼叫端使用 ICertSrvSetupKeyInformation 物件完成時，呼叫端必須使用 Release 方法來釋放它。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 casetup.h
Dll Certocm.dll

另請參閱

ICertSrvSetup