SslCreateHandshakeHash 함수

SslCreateHandshakeHash 함수는 핸드셰이크 메시지를 해시하는 데 사용되는 해시 핸들을 가져옵니다.

구문

SECURITY_STATUS WINAPI SslCreateHandshakeHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwFlags
);

매개 변수

hSslProvider [in]

SSL(Secure Sockets Layer protocol) 프로토콜 공급자의 핸들은 instance.

phHandshakeHash [out]

다른 SSL 공급자 함수에 전달할 수 있는 해시 핸들입니다.

dwProtocol [in]

CNG SSL 공급자 프로토콜 식별자 값 중 하나입니다.

참고

이 함수는 SSL 2.0 프로토콜과 함께 사용되지 않습니다.

dwCipherSuite [in]

CNG SSL 공급자 암호 그룹 식별자 값 중 하나입니다.

dwFlags [in]

이 매개 변수는 나중에 사용하도록 예약되어 있습니다.

반환 값

함수가 성공하면 0을 반환합니다.

함수가 실패하면 0이 아닌 오류 값이 반환됩니다.

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

반환 코드/값	설명
NTE_NO_MEMORY 0x8009000EL	해시 버퍼를 할당할 메모리가 부족합니다.
NTE_INVALID_HANDLE 0x80090026L	hSslProvider 핸들이 잘못되었습니다.
NTE_INVALID_PARAMETER 0x80090027L	phHandshakeHash가 null입니다.

설명

SslCreateHandshakeHash 함수는 SSL 핸드셰이크 중에 사용할 해시를 생성하는 데 사용되는 세 가지 함수 중 하나입니다.

1. SslCreateHandshakeHash 함수는 해시 핸들을 가져오기 위해 호출됩니다.
2. SslHashHandshake 함수는 해시 핸들을 사용하여 해시에 데이터를 추가하는 여러 번 호출됩니다.
3. 해시된 데이터의 다이제스트를 가져오기 위해 해시 핸들을 사용하여 SslComputeFinishedHash 함수를 호출합니다.

요구 사항

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