Функция SslGenerateSessionKeys

Функция SslGenerateSessionKeys создает набор ключей сеанса SSL.

Синтаксис

SECURITY_STATUS WINAPI SslGenerateSessionKeys(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _Out_ NCRYPT_KEY_HANDLE  *phReadKey,
  _Out_ NCRYPT_KEY_HANDLE  *phWriteKey,
  _In_  PNCryptBufferDesc  pParameterList,
  _In_  DWORD              dwFlags
);

Параметры

hSslProvider [in]

Дескриптор экземпляра поставщика протокола SSL.

hMasterKey [in]

Дескриптор объекта ключа master.

phReadKey [out]

Указатель на возвращенный дескриптор ключа чтения.

phWriteKey [out]

Указатель на возвращенный дескриптор ключа записи.

pParameterList [in]

Указатель на массив буферов NCryptBuffer , содержащих сведения, используемые в рамках операции обмена ключами. Точный набор буферов зависит от используемого протокола и набора шифров. Как минимум, список будет содержать буферы, содержащие предоставленные клиентом и сервером случайные значения.

dwFlags [in]

Этот параметр зарезервирован для использования в будущем.

Возвращаемое значение

Если функция завершается успешно, она возвращает ноль.

Если функция завершается сбоем, она возвращает ненулевое значение ошибки.

Возможные коды возврата включают, помимо прочего, следующие.

Возвращаемый код/значение	Описание
NTE_NO_MEMORY 0x8009000EL	Недостаточно памяти для выделения необходимых буферов.
NTE_INVALID_HANDLE 0x80090026L	Один из предоставленных дескрипторов недопустим.
NTE_INVALID_PARAMETER 0x80090027L	Параметр phReadKey или phWriteKey имеет значение NULL.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Sslprovider.h
DLL	Ncrypt.dll