SslCreateClientAuthHash 함수
SslCreateClientAuthHash 함수는 클라이언트 인증에 사용되는 핸드셰이크 해시에 대한 핸들을 검색합니다.
구문
SECURITY_STATUS WINAPI SslCreateClientAuthHash(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
_In_ DWORD dwProtocol,
_In_ DWORD dwCipherSuite,
_In_ LPCWSTR pszHashAlgId,
_In_ DWORD dwFlags
);
매개 변수
-
hSslProvider [in]
-
SSL(Secure Sockets Layer protocol) 프로토콜 공급자의 핸들은 instance.
-
phHandshakeHash [out]
-
해시 핸들을 받을 NCRYPT_HASH_HANDLE 변수에 대한 포인터입니다.
-
dwProtocol [in]
-
CNG SSL 공급자 프로토콜 식별자 값 중 하나입니다.
-
dwCipherSuite [in]
-
CNG SSL 공급자 암호 그룹 식별자 값 중 하나입니다.
-
pszHashAlgId [in]
-
CNG 알고리즘 식별자 값 중 하나입니다.
-
dwFlags [in]
-
이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정해야 합니다.
반환 값
함수가 성공하면 0을 반환합니다.
함수가 실패하면 0이 아닌 오류 값이 반환됩니다.
가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
hSslProvider 매개 변수에는 유효하지 않은 포인터가 포함되어 있습니다. |
|
phHandshakeHash 매개 변수가 NULL로 설정됩니다. |
|
선택한 함수는 지정된 버전의 인터페이스에서 지원되지 않습니다. |
|
버퍼를 할당할 메모리가 부족합니다. |
|
dwFlags 매개 변수는 0으로 설정해야 합니다. |
설명
SslCreateClientAuthHash 함수는 TLS(전송 계층 보안 프로토콜) 1.2 이상 대화에 대해 호출되어 핸드셰이크 메시지를 해시하는 데 사용되는 해시 개체를 만듭니다. 클라이언트 인증 서명에서 사용할 수 있는 가능한 각 해시 알고리즘 에 대해 한 번 호출됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 헤더 |
|
| DLL |
|