SslHashHandshake function

Article
01/07/2021

The SslHashHandshake function returns a handle to the handshake hash.

Syntax

SECURITY_STATUS WINAPI SslHashHandshake(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _Inout_ NCRYPT_HASH_HANDLE hHandshakeHash,
  _Out_   PBYTE              pbInput,
  _In_    DWORD              cbInput,
  _In_    DWORD              dwFlags
);

Parameters

hSslProvider [in]: The handle to the Secure Sockets Layer protocol (SSL) protocol provider instance.
hHandshakeHash [in, out]: The handle to the hash object.
pbInput [out]: The address of a buffer that contains the data to be hashed.
cbInput [in]: The size, in bytes, of the pbInput buffer.
dwFlags [in]: This parameter is reserved for future use.

Return value

If the function succeeds, it returns zero.

Remarks

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

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

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Sslprovider.h
DLL	Ncrypt.dll

Share via