IX509PrivateKey：：Import 方法 (certenroll.h)

Import 方法會將現有的私鑰匯入密碼編譯提供者內的密鑰容器。

語法

HRESULT Import(
  [in] BSTR         strExportType,
  [in] BSTR         strEncodedKey,
  [in] EncodingType Encoding
);

[in] strExportType

如果使用 CNG KSP (金鑰儲存提供者建立金鑰 ) ，Import 方法會將這個自變數傳遞至 NCryptSetProperty 函式的 pszProperty 參數。也就是說，您指定的值將用來做為要設定在匯入索引鍵上的屬性名稱。

如果使用 CryptoAPI CSP 建立金鑰 (密碼編譯服務提供者) ，則此自變數會指定私鑰的匯入方式。這可以是下列值。

值	意義
BCRYPT_PRIVATE_KEY_BLOB	匯入整個私鑰。

[in] strEncodedKey

BSTR 變數，其中包含要匯入的索引鍵。

[in] Encoding

EncodingType 列舉值，指定要套用至 strEncodedKey 參數中包含的字串的 Unicode 編碼類型。預設值為 XCN_CRYPT_STRING_BASE64。

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 HRESULT 值，指出錯誤。可能的值包括 (但不限於) 下表中的這些值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

傳回碼	Description
HRESULT_FROM_WIN32 (ERROR_FILE_READ_ONLY)	金鑰容器已經開啟。如果您已經呼叫 Open 或 Create，則可以收到此錯誤。
HRESULT_FROM_WIN32 (ERROR_CALL_NOT_IMPLEMENTED)	密鑰是由 CryptoAPI CSP 所建立，而且您指定了 strExportType 參數BCRYPT_PRIVATE_KEY_BLOB以外的值。

如果您為 strExportType 參數指定了非BCRYPT_PRIVATE_KEY_BLOB值，而且您未設定下列任何屬性，則 Import 函式會自動假設您嘗試匯入 CNG KSP 索引鍵：