Share via

SslLookupCipherLengths 函数

  • 项目

SslLookupCipherLengths 函数返回一个NCRYPT_SSL_CIPHER_LENGTHS结构，该结构包含输入协议、密码套件和密钥类型的标头和尾部长度。

语法

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _In_  DWORD                     dwFlags
);

参数

hSslProvider [in]

安全套接字层协议的句柄 (SSL) 协议提供程序实例。

dwProtocol [in]

CNG SSL 提供程序协议标识符值之一。

dwCipherSuite [in]

CNG SSL 提供程序密码套件标识符值之一。

dwKeyType [in]

CNG SSL 提供程序密钥类型标识符值之一。 对于不是 ECC) (椭圆曲线加密 的密钥类型，请将此参数设置为零。

pCipherLengths [out]

指向要接收NCRYPT_SSL_CIPHER_LENGTHS结构的缓冲区 的 指针。

cbCipherLengths [in]

pCipherLengths 参数指向的缓冲区的长度（以字节为单位）。

dwFlags [in]

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

返回值

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

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

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

返回代码/值 说明
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider 参数包含无效的指针。
NTE_INVALID_PARAMETER
0x80090027L
 pCipherLengths 参数设置为 NULL，或者 cbCipherLengths 指定的缓冲区长度太短。
NTE_BAD_FLAGS
0x80090009L
 dwFlags 参数必须设置为零。

备注

传输层安全协议 (TLS) 1.1 或更高版本的会话调用 SslLookupCipherLengths 函数，以查询所请求协议、密码套件和密钥类型的标头和尾部长度。

要求

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