BCryptImportKeyPair 函式 （bcrypt.h）

BCryptImportKeyPair 函式會從密鑰 BLOB匯入 公開/私鑰組。 BCryptImportKey 函式是用來匯入 對稱密鑰。

語法

NTSTATUS BCryptImportKeyPair(
  [in]      BCRYPT_ALG_HANDLE hAlgorithm,
  [in, out] BCRYPT_KEY_HANDLE hImportKey,
  [in]      LPCWSTR           pszBlobType,
  [out]     BCRYPT_KEY_HANDLE *phKey,
  [in]      PUCHAR            pbInput,
  [in]      ULONG             cbInput,
  [in]      ULONG             dwFlags
);

參數

[in] hAlgorithm

要匯入金鑰之演算法提供者的句柄。 呼叫 BCryptOpenAlgorithmProvider 函式來取得此句柄。

[in, out] hImportKey

此參數目前未使用，而且應該是 NULL。

[in] pszBlobType

Null 終止的 Unicode 字串，其中包含標識碼，指定包含在 pbInput 緩衝區中的 BLOB 類型。 這可以是下列其中一個值：

[out] phKey

接收匯入索引鍵句柄之 BCRYPT_KEY_HANDLE 的指標。 此句柄用於需要索引鍵的後續函式，例如 BCryptSignHash。 當不再需要此句柄時，必須將它傳遞至 BCryptDestroyKey 函式來釋放它。

[in] pbInput

緩衝區的位址，其中包含要匯入的 金鑰 BLOB。 cbInput 參數包含這個緩衝區的大小。 pszBlobType 參數會指定此緩衝區所包含的密鑰 BLOB 類型。

[in] cbInput

pbInput 緩衝區的大小，以位元組為單位。

[in] dwFlags

一組旗標，可修改此函式的行為。 這可以是零或下列值。

傳回值

傳回狀態代碼，指出函式的成功或失敗。

可能的回傳代碼包括但不限於下列代碼：

言論

根據提供者支持的處理器模式，BCryptImportKeyPair 可以從使用者模式或核心模式呼叫。 核心模式呼叫端可以在 IRQL PASSIVE_LEVEL或 DISPATCH_LEVEL IRQL 上執行。 如果目前的 IRQL 層級是 DISPATCH_LEVEL，則 hAlgorithm 參數中提供的句柄必須使用 BCRYPT_PROV_DISPATCH 旗標開啟，而且傳遞至 BCryptImportKeyPair 函式的任何指標都必須參考未分頁或鎖定的記憶體。

當密鑰不再使用時，呼叫端應使用 BCryptDestroyKey 釋放 hKey。

若要在核心模式中呼叫此函式，請使用 Cng.lib，這是驅動程式開發工具包 （DDK） 的一部分。 Windows Server 2008 和 Windows Vista： 若要在核心模式中呼叫此函式，請使用 Ksecdd.lib。

要求

另請參閱

BCryptDestroyKey

BCryptExportKey

BCryptImportKey