SslCreateHandshakeHash function

The SslCreateHandshakeHash function obtains a hash handle that is used to hash handshake messages.

Syntax

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

Parameters

hSslProvider [in]

The handle of the Secure Sockets Layer protocol (SSL) protocol provider instance.

phHandshakeHash [out]

A hash handle that can be passed to other SSL provider functions.

dwProtocol [in]

One of the CNG SSL Provider Protocol Identifier values.

Note  This function is not used with the SSL 2.0 protocol.

 

dwCipherSuite [in]

One of the CNG SSL Provider Cipher Suite Identifier values.

dwFlags [in]

This parameter is reserved for future use.

Return value

If the function succeeds, it returns zero.

If the function fails, it returns a nonzero error value.

Possible return codes include, but are not limited to, the following.

Remarks

The SslCreateHandshakeHash function is one of three functions used to generate a hash to use during the SSL handshake.

1. The SslCreateHandshakeHash function is called to obtain a hash handle.
2. The SslHashHandshake function is called any number of times with the hash handle to add data to the hash.
3. The SslComputeFinishedHash function is called with the hash handle to obtain the digest of the hashed data.

Requirements