共用方式為


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]

此參數保留供日後使用,且必須設定為零。

傳回值

如果函式成功,則會傳回零。

如果函式失敗,它會傳回非零錯誤值。

可能的傳回碼包括但不限於下列各項。

傳回碼/值 Description
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