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

  • Статья

Функция SpInitUserModeContext создает контекст безопасности пользовательского режима из упакованного контекста в режиме локального центра безопасности (LSA).

Синтаксис

SpInitUserModeContextFn Spinitusermodecontextfn;

NTSTATUS Spinitusermodecontextfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBuffer PackedContext
)
{...}

Параметры

[in] ContextHandle

Дескриптор контекста режима LSA, возвращаемый функцией SpInitLsaModeContext или SpAcceptLsaModeContext .

[in] PackedContext

Указатель на структуру SecBuffer , содержащую сериализованные контекстные данные. Используйте функцию FreeContextBuffer , чтобы освободить память, выделенную для этой структуры.

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

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

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

Код возврата Описание
STATUS_INSUFFICIENT_RESOURCES
 Недостаточно памяти для создания контекста.

Комментарии

Функция SpInitUserModeContext вызывается после создания контекста безопасности пакетом безопасности, если параметр MappedContextspInitLsaModeContext или SpAcceptLsaModeContext имеет значение TRUE. Контекстные данные пакета должны содержать сведения, необходимые для определения функции, которая привела к вызову SpInitUserModeContext.

SSP/APs должны реализовывать функцию SpInitUserModeContext ; однако фактическое имя, присваиваемого реализации, задается разработчиком.

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

Требования

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

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

SECPKG_USER_FUNCTION_TABLE

SpAcceptLsaModeContext

SpInitLsaModeContext

SpUserModeInitialize