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


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

Функция 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

См. также раздел

DecryptMessage (Schannel)

ImpersonateSecurityContext

SCHANNEL_ALERT_TOKEN

SCHANNEL_SESSION_TOKEN

Функции SSPI

SecBuffer

SecBufferDesc