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
NTE_INVALID_HANDLE
0x80090026L
hSslProvider參數包含不正確指標。
NTE_INVALID_PARAMETER
0x80090027L
szPRFHash參數設定為Null
NTE_NOT_SUPPORTED
0x80090029L
指定的介面版本不支援選取的函式。
NTE_BAD_FLAGS
0x80090009L
dwFlags參數必須設定為零。

備註

SslGetCipherSuitePRFHashAlgorithm 函式會針對 TLS 1.2 或更新版本交談呼叫,以查詢將在 TLS PRF 中使用的雜湊演算法。

規格需求

需求
最低支援的用戶端
Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2008 R2 [僅限傳統型應用程式]
標頭
Sslprovider.h
DLL
Ncrypt.dll