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

Статья
08/26/2023

Функция ApplyControlToken предоставляет способ применения маркера управления к контексту безопасности. Маркер может быть получен, когда контекст безопасности устанавливается путем вызова функции InitializeSecurityContext (Schannel) или с помощью службы безопасности для каждого сообщения, такой как проверка или незасекреченность.

Эта функция поддерживается только поставщиком поддержки безопасности (SSP) Schannel.

Эта функция не поддерживается в режиме ядра.

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

Синтаксис

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

Параметры

[in] phContext

Дескриптор контекста, к которому применяется маркер.

Сведения о том, как поставщик Schannel SSP уведомляет удаленную сторону о завершении работы, см. в разделе Примечания статьи DecryptMessage (Schannel). Дополнительные сведения об использовании этой функции см. в разделе Завершение работы подключения Schannel.

[in] pInput

Указатель на структуру SecBufferDesc , содержащую указатель на структуру SecBuffer , содержащую входной маркер для применения к контексту.

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

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

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

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

Функция ApplyControlToken может изменять контекст на основе этого токена. Среди маркеров, которые эта функция может добавить в контекст клиента , SCHANNEL_ALERT_TOKEN и SCHANNEL_SESSION_TOKEN.

Эту функцию можно использовать для завершения работы контекста безопасности , лежащего в основе существующего подключения Schannel. Сведения о том, как это сделать, см. в разделе Завершение работы подключения Schannel.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	sspi.h (включая Security.h)
Библиотека	Secur32.lib
DLL	Secur32.dll