Функция SslEncryptPacket

Статья
06/13/2023

Функция SslEncryptPacket шифрует один ssl-пакет.

Синтаксис

SECURITY_STATUS WINAPI SslEncryptPacket(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _Inout_ NCRYPT_KEY_HANDLE  hKey,
  _In_    PBYTE              *pbInput,
  _In_    DWORD              cbInput,
  _Out_   PBYTE              pbOutput,
  _In_    DWORD              cbOutput,
  _Out_   DWORD              *pcbResult,
  _In_    ULONGLONG          SequenceNumber,
  _In_    DWORD              dwContentType,
  _In_    DWORD              dwFlags
);

Параметры

hSslProvider [in]

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

hKey [in, out]

Дескриптор ключа, используемого для шифрования пакета.

pbInput [in]

Указатель на буфер, содержащий зашифрованный пакет.

cbInput [in]

Длина буфера pbInput (в байтах).

pbOutput [out]

Указатель на буфер для получения зашифрованного пакета.

cbOutput [in]

Длина буфера pbOutput в байтах.

pcbResult [out]

Число байтов, записанных в буфер pbOutput .

SequenceNumber [in]

Порядковый номер, соответствующий этому пакету.

dwContentType [in]

Тип контента, соответствующий данному пакету, который указывает протокол более высокого уровня, используемый для обработки вложенного пакета.

Значение	Значение
CT_CHANGE_CIPHER_SPEC 20	Указывает на изменение стратегии шифрования.
CT_ALERT 21	Указывает, что вложенный пакет содержит оповещение.
CT_HANDSHAKE 22	Указывает, что вложенный пакет является частью протокола подтверждения.
CT_APPLICATIONDATA 23	Указывает, что пакет содержит данные приложения.

dwFlags [in]

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

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

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

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

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

Возвращаемый код или значение	Описание
NTE_INVALID_HANDLE 0x80090026L	Один из предоставленных дескрипторов недопустим.

Требования

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