Функция SetContextAttributesA (sspi.h)

Статья
11/20/2024

Позволяет приложению транспорта задавать атрибуты контекста безопасности дляпакета безопасности. Эта функция поддерживается только пакетом безопасности Schannel.

Синтаксис

SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

Параметры

[in] phContext

Дескриптор заданного контекста безопасности.

[in] ulAttribute

Атрибут заданного контекста. Этот параметр может быть одним из следующих значений.

Ценность	Значение
SECPKG_ATTR_APP_DATA 94	Параметр pBuffer содержит указатель на структуру SecPkgContext_SessionAppData. Задает данные приложения для сеанса. Этот атрибут поддерживается только пакетом безопасности Schannel.
SECPKG_ATTR_EAP_PRF_INFO 101	Параметр pBuffer содержит указатель на структуру SecPkgContext_EapPrfInfo. Задает псевдослучайную функцию (PRF), используемую протоколом расширенной проверки подлинности (EAP). Это значение, возвращаемое вызовом функции QueryContextAttributes (Schannel), когда SECPKG_ATTR_EAP_KEY_BLOCK передается в качестве значения параметра ulAttribute. Этот атрибут поддерживается только пакетом безопасности Schannel.
SECPKG_ATTR_EARLY_START 105	Параметр pBuffer содержит указатель на структуру SecPkgContext_EarlyStart. Задает функцию False Start. Дополнительные сведения об этой функции см. в записи блога создании более быстрого и безопасного веб-.
SECPKG_ATTR_DTLS_MTU 34	Задает и извлекает значение MTU (максимальная единица передачи) для использования с DTLS. Если DTLS не включен в контексте безопасности, этот атрибут не поддерживается. Допустимые значения : от 200 байт до 64 килобайтов. Значение MTU по умолчанию DTLS в Schannel равно 1096 байтам.
SECPKG_ATTR_KEYING_MATERIAL_INFO 106	Параметр pBuffer содержит указатель на структуру SecPkgContext_KeyingMaterialInfo. Функция экспорта материалов ключей следует стандарту RFC 5705. Этот атрибут поддерживается только пакетом безопасности Schannel в Windows 10 и Windows Server 2016 или более поздних версиях.

[in] pBuffer

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

[in] cbBuffer

Размер в байтах параметра pBuffer.

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

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

Если функция завершается ошибкой, она возвращает ненулевой код ошибки. Следующий код ошибки является одним из возможных кодов ошибок.

Возвращаемый код	Описание
SEC_E_UNSUPPORTED_FUNCTION	Это значение возвращается в режиме ядра Schannel, чтобы указать, что эта функция не поддерживается.

Замечания

Заметка

Заголовок sspi.h определяет SetContextAttributes в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	sspi.h (include Security.h)
библиотеки	Secur32.lib
DLL	Secur32.dll

Поделиться через