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(Secure Sockets Layer protocol) 프로토콜 공급자의 핸들은 instance.
-
dwProtocol [in]
-
CNG SSL 공급자 프로토콜 식별자 값 중 하나입니다.
-
dwCipherSuite [in]
-
CNG SSL 공급자 암호 그룹 식별자 값 중 하나입니다.
-
dwKeyType [in]
-
CNG SSL 공급자 키 형식 식별자 값 중 하나입니다. ECC( 타원 곡선 암호화 )가 아닌 키 형식의 경우 이 매개 변수를 0으로 설정합니다.
-
pCipherLengths [out]
-
NCRYPT_SSL_CIPHER_LENGTHS 구조를 수신할 버퍼에 대한 포인터입니다.
-
cbCipherLengths [in]
-
pCipherLengths 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.
-
dwFlags [in]
-
이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정해야 합니다.
반환 값
함수가 성공하면 0을 반환합니다.
함수가 실패하면 0이 아닌 오류 값이 반환됩니다.
가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
hSslProvider 매개 변수에는 유효하지 않은 포인터가 포함되어 있습니다. |
|
pCipherLengths 매개 변수가 NULL로 설정되거나 cbCipherLengths에서 지정한 버퍼 길이가 너무 짧습니다. |
|
dwFlags 매개 변수는 0으로 설정해야 합니다. |
설명
SslLookupCipherLengths 함수는 요청된 프로토콜, 암호 그룹 및 키 형식에 대한 헤더 및 트레일러 길이를 쿼리하기 위해 TLS(전송 계층 보안 프로토콜) 1.1 이상 대화에 대해 호출됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 헤더 |
|
| DLL |
|