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 |
---|---|
|
hSslProvider參數包含不正確指標。 |
|
pCipherLengths參數會設定為Null,或cbCipherLengths指定的緩衝區長度太短。 |
|
dwFlags參數必須設定為零。 |
備註
針對傳輸層安全性通訊協定 (TLS) 1.1 或更新版本的交談呼叫SslLookupCipherLengths函式,以查詢所要求通訊協定、加密套件和金鑰類型的標頭和預告片長度。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2008 R2 [僅限傳統型應用程式] |
標頭 |
|
DLL |
|