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

Статья
08/25/2023

Функция SpInitialize вызывается один раз местным центром безопасности (LSA), чтобы предоставить пакет безопасности с общими сведениями о безопасности и таблицу диспетчеризации функций поддержки. Пакет безопасности должен сохранить сведения и выполнить внутреннюю обработку инициализации, если это необходимо.

Синтаксис

SpInitializeFn Spinitializefn;

NTSTATUS Spinitializefn(
  [in] ULONG_PTR PackageId,
  [in] PSECPKG_PARAMETERS Parameters,
  [in] PLSA_SECPKG_FUNCTION_TABLE FunctionTable
)
{...}

Параметры

[in] PackageId

Уникальный идентификатор, который LSA назначает каждому пакету безопасности. Значение является допустимым до перезапуска системы.

[in] Parameters

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

[in] FunctionTable

Указатель на таблицу поддержки LSA функций, которые может вызывать пакет безопасности.

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

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

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

Если SpInitialize возвращает код ошибки NTSTATUS в LSA, пакет будет выгружен, а локальный центр безопасности (LSA) не будет включать его в список доступных пакетов безопасности.

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

Указатель на реализацию SSP/AP функции SpInitialize должен находиться в структуре SECPKG_FUNCTION_TABLE , передаваемой LSA из функции SpLsaModeInitialize .

Требования

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

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

SECPKG_FUNCTION_TABLE

SECPKG_PARAMETERS

SpLsaModeInitialize

Share via