通过

SslGetCipherSuitePRFHashAlgorithm 函数

  • 项目

SslGetCipherSuitePRFHashAlgorithm 函数返回加密 API：下一代 (CNG) 算法标识符，该算法用于传输层安全性协议 (TLS) 伪随机函数， (输入协议、密码套件和密钥类型的 PRF) 。

语法

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]

此参数保留供将来使用，必须设置为零。

返回值

如果该函数成功，则返回零。

如果函数失败，它将返回非零错误值。

可能的返回代码包括但不限于以下内容。

返回代码/值 说明
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider 参数包含无效的指针。
NTE_INVALID_PARAMETER
0x80090027L
 szPRFHash 参数设置为 NULL。
NTE_NOT_SUPPORTED
0x80090029L
 指定的接口版本不支持所选函数。
NTE_BAD_FLAGS
0x80090009L
 dwFlags 参数必须设置为零。

备注

为 TLS 1.2 或更高版本的会话调用此 SslGetCipherSuitePRFHashAlgorithm 函数，以查询将在 TLS PRF 中使用的哈希算法。

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 R2 [仅限桌面应用]
标头
Sslprovider.h
DLL
Ncrypt.dll