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이 아닌 오류 값이 반환됩니다.

가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드/값	설명
NTE_INVALID_HANDLE 0x80090026L	hSslProvider 매개 변수에는 유효하지 않은 포인터가 포함되어 있습니다.
NTE_INVALID_PARAMETER 0x80090027L	pCipherLengths 매개 변수가 NULL로 설정되거나 cbCipherLengths에서 지정한 버퍼 길이가 너무 짧습니다.
NTE_BAD_FLAGS 0x80090009L	dwFlags 매개 변수는 0으로 설정해야 합니다.

설명

SslLookupCipherLengths 함수는 요청된 프로토콜, 암호 그룹 및 키 형식에 대한 헤더 및 트레일러 길이를 쿼리하기 위해 TLS(전송 계층 보안 프로토콜) 1.1 이상 대화에 대해 호출됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
헤더	Sslprovider.h
DLL	Ncrypt.dll