SslGetCipherSuitePRFHashAlgorithm 함수
SslGetCipherSuitePRFHashAlgorithm 함수는 입력 프로토콜, 암호 그룹 및 키 형식에 대한 TLS(전송 계층 보안 프로토콜) PRF(의사 임의 함수)에 사용되는 해시 알고리즘의 암호화 API: 차세대(CNG) 알고리즘 식별자를 반환합니다.
구문
SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ DWORD dwProtocol,
_In_ DWORD dwCipherSuite,
_In_ DWORD dwKeyType,
_Out_ WCHAR szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
_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으로 설정합니다.
-
szPRFHash [out]
-
TLS PRF에 사용할 해시의 CNG 알고리즘 식별자 중 하나입니다.
-
dwFlags [in]
-
이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정해야 합니다.
반환 값
함수가 성공하면 0을 반환합니다.
함수가 실패하면 0이 아닌 오류 값이 반환됩니다.
가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
hSslProvider 매개 변수에는 유효하지 않은 포인터가 포함되어 있습니다. |
|
szPRFHash 매개 변수는 NULL로 설정됩니다. |
|
선택한 함수는 지정된 버전의 인터페이스에서 지원되지 않습니다. |
|
dwFlags 매개 변수는 0으로 설정해야 합니다. |
설명
이 SslGetCipherSuitePRFHashAlgorithm 함수는 TLS PRF에서 사용할 해시 알고리즘을 쿼리하기 위해 TLS 1.2 이상 대화에 대해 호출됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 헤더 |
|
| DLL |
|