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

  • Статья

Функция CompleteAuthToken завершает маркер проверки подлинности. Эта функция используется протоколами, такими как DCE, которые должны пересмотреть сведения о безопасности после того, как транспортное приложение обновило некоторые параметры сообщения.

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

CompleteAuthToken используется только на стороне сервера.

Синтаксис

SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pToken
);

Параметры

[in] phContext

Дескриптор контекста, который необходимо завершить.

[in] pToken

Указатель на структуру SecBufferDesc , содержащую дескриптор буфера для всего сообщения.

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

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

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

Код возврата Описание
SEC_E_INVALID_HANDLE
 Дескриптор, переданный функции, недопустим.
SEC_E_INVALID_TOKEN
 Маркер, переданный функции, недопустим.
SEC_E_OUT_OF_SEQUENCE
 Контекст безопасности клиента был найден, но номер сообщения неправильный. Это возвращаемое значение используется с дайджест-поставщиком общих служб.
SEC_E_MESSAGE_ALTERED
 Контекст безопасности клиента был найден, но сообщение клиента было изменено. Это возвращаемое значение используется с дайджест-поставщиком общих служб.
SEC_E_INTERNAL_ERROR
 Произошла ошибка, не сопоставленная с кодом ошибки SSPI.

Комментарии

Клиент транспортного приложения вызывает функцию CompleteAuthToken , чтобы пакет безопасности обновлял контрольную сумму или аналогичную операцию после обновления всех заголовков протокола транспортным приложением. Клиент вызывает эту функцию, только если вызов InitializeSecurityContext (Digest) вернул SEC_I_COMPLETE_NEEDED или SEC_I_COMPLETE_AND_CONTINUE.

Требования

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

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

InitializeSecurityContext (digest)

Функции SSPI

SecBufferDesc