SslImportKey 函式
SslImportKey函式會將金鑰匯入安全通訊端層通訊協定, (SSL) 通訊協定提供者。
語法
SECURITY_STATUS WINAPI SslImportKey(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Out_ NCRYPT_KEY_HANDLE *phKey,
_In_ LPCWSTR pszBlobType,
_In_ PBYTE pbKeyBlob,
_In_ DWORD cbKeyBlob,
_In_ DWORD dwFlags
);
參數
-
hSslProvider [in]
-
SSL 通訊協定提供者實例的控制碼。
-
phKey [out]
-
要接收匯入金鑰之 密碼編譯金鑰 控制碼的指標。
-
pszBlobType [in]
-
Null 終止的 Unicode 字串,包含識別碼,指定pbInput緩衝區中包含的BLOB類型。 這可以是下列其中一個值。
值 意義 - BCRYPT_DH_PUBLIC_BLOB
匯出Diffie-Hellman 公開金鑰。 pbOutput緩衝區會立即接收BCRYPT_DH_KEY_BLOB結構,後面接著索引鍵資料。 - BCRYPT_ECCPUBLIC_BLOB
匯出 橢圓曲線加密 (ECC) 公開金鑰。 pbOutput緩衝區會立即接收BCRYPT_ECCKEY_BLOB結構,後面接著索引鍵資料。 - BCRYPT_OPAQUE_KEY_BLOB
以單一密碼編譯服務提供者特定的格式匯出對稱金鑰, (CSP) 。 不透明 BLOB 無法傳輸,而且必須使用產生 BLOB 的相同 CSP 來匯入。 - BCRYPT_RSAPUBLIC_BLOB
匯出 RSA 公開金鑰。 pbOutput緩衝區會立即接收BCRYPT_RSAKEY_BLOB結構,後面接著索引鍵資料。 -
pbKeyBlob [in]
-
緩衝區的指標,其中包含 金鑰 BLOB。
-
cbKeyBlob [in]
-
pbKeyBlob緩衝區的大小,以位元組為單位。
-
dwFlags [in]
-
這個參數保留給未來使用。
傳回值
如果函式成功,則會傳回零。
如果函式失敗,它會傳回非零錯誤值。
可能的傳回碼包括但不限於下列各項。
傳回碼/值 | Description |
---|---|
|
記憶體不足,無法配置必要的緩衝區。 |
|
hSslProvider控制碼無效。 |
|
phKey參數為Null。 |
備註
您可以使用 SslImportKey 函式,將工作階段金鑰匯入為將工作階段金鑰從一個進程傳輸到另一個進程的一部分。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
標頭 |
|
DLL |
|