Функция обратного вызова SpGetContextTokenFn (ntsecpkg.h)

  • Статья

Получает токен для олицетворения. Функция SpGetContextToken используется функцией SSPI ImpersonateSecurityContext для получения токена для олицетворения.

Синтаксис

SpGetContextTokenFn Spgetcontexttokenfn;

NTSTATUS Spgetcontexttokenfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [out] PHANDLE ImpersonationToken
)
{...}

Параметры

[in] ContextHandle

Дескриптор контекста для олицетворения.

[out] ImpersonationToken

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

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

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

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

Код возврата Описание
SEC_E_INVALID_HANDLE
 Недопустимый дескриптор.

Комментарии

Поставщики общих служб и поставщики услуг должны реализовывать функцию SpGetContextToken ; однако фактическое имя, присваиваемого реализации, определяется разработчиком.

Указатель на функцию SpGetContextToken доступен в структуре SECPKG_USER_FUNCTION_TABLE , полученной от функции SpUserModeInitialize .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecpkg.h

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

ImpersonateSecurityContext

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize