SslComputeEapKeyBlock function

The SslComputeEapKeyBlock function computes the key block used by the Extensible Authentication Protocol (EAP).

Syntax

SECURITY_STATUS WINAPI SslComputeEapKeyBlock(
  _In_      NCRYPT_PROV_HANDLE hSslProvider,
  _In_      NCRYPT_KEY_HANDLE  hMasterKey,
  _In_      PBYTE              pbRandoms,
  _In_      DWORD              cbRandoms,
  _Out_opt_ PBYTE              pbOutput,
  _In_      DWORD              cbOutput,
  _Out_     DWORD              *pcbResult,
  _In_      DWORD              dwFlags
);

Parameters

hSslProvider [in]

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

hMasterKey [in]

The handle of the master key object.

pbRandoms [in]

A pointer to a buffer that contains a concatenation of the client_random and server_random values of the SSL session.

cbRandoms [in]

The length, in bytes, of the pbRandoms buffer.

pbOutput [out, optional]

The address of a buffer that receives the key BLOB. The cbOutput parameter contains the size of this buffer. If this parameter is NULL, this function will place the required size, in bytes, in the DWORD pointed to by the pcbResult parameter.

cbOutput [in]

The length, in bytes, of the pbOutput buffer.

pcbResult [out]

A pointer to a DWORD value that specifies the length, in bytes, of the hash written to the pbOutput buffer.

dwFlags [in]

Set to NCRYPT_SSL_SERVER_FLAG to indicate that this is a server call.

Return value

If the function succeeds, it returns zero.

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

Return code/value Description
NTE_INVALID_HANDLE
0x80090026L
One of the supplied handles is not valid.

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