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