SslGetCipherSuitePRFHashAlgorithm 函式
SslGetCipherSuitePRFHashAlgorithm函式會傳回密碼編譯 API：適用于傳輸層安全性通訊協定 (TLS) 虛擬隨機函式 (PRF) 輸入通訊協定、加密套件和金鑰類型的雜湊演算法的新一代 (C) NG 演算法識別碼。
語法
SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ DWORD dwProtocol,
_In_ DWORD dwCipherSuite,
_In_ DWORD dwKeyType,
_Out_ WCHAR szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
_In_ DWORD dwFlags
);
參數
-
hSslProvider [in]
-
安全通訊端層通訊協定的控制碼 (SSL) 通訊協定提供者實例。
-
dwProtocol [in]
-
其中一個 CNG SSL 提供者通訊協定識別碼 值。
-
dwCipherSuite [in]
-
其中一個 CNG SSL 提供者加密套件識別碼 值。
-
dwKeyType [in]
-
其中一個 CNG SSL 提供者金鑰類型識別碼 值。 對於不是 橢圓曲線加密的金鑰 類型， (ECC) ，請將此參數設定為零。
-
szPRFHash [out]
-
將用於 TLS PRF 之雜湊的其中一個 CNG 演算法識別碼 。
-
dwFlags [in]
-
此參數保留供日後使用，且必須設定為零。
傳回值
如果函式成功，則會傳回零。
如果函式失敗，它會傳回非零錯誤值。
可能的傳回碼包括但不限於下列各項。
| 傳回碼/值 | Description |
|---|---|
|
hSslProvider參數包含不正確指標。 |
|
szPRFHash參數設定為Null。 |
|
指定的介面版本不支援選取的函式。 |
|
dwFlags參數必須設定為零。 |
備註
此 SslGetCipherSuitePRFHashAlgorithm 函式會針對 TLS 1.2 或更新版本交談呼叫，以查詢將在 TLS PRF 中使用的雜湊演算法。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 R2 [僅限傳統型應用程式] |
| 標頭 |
|
| DLL |
|