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

  • Статья

Функция SpGetUserInfo извлекает сведения о сеансе входа.

Синтаксис

SpGetUserInfoFn Spgetuserinfofn;

NTSTATUS Spgetuserinfofn(
  [in]  PLUID LogonId,
  [in]  ULONG Flags,
  [out] PSecurityUserData *UserData
)
{...}

Параметры

[in] LogonId

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

[in] Flags

Задает допустимую длину доменного имени в качестве одного из следующих значений.

Значение Значение
NO_LONG_NAMES
 Возвращаемое доменное имя не может быть длиннее 15 символов.
UNDERSTANDS_LONG_NAMES
 Возвращаемое доменное имя может быть длиннее 15 символов.

[out] UserData

Указатель на указатель на структуру SecurityUserData . Если вызов функции завершается успешно, сведения о пользователе возвращаются в этой структуре. Пакет безопасности должен выделить память для этой структуры в адресном пространстве вызывающего объекта. Вызывающий объект отвечает за освобождение буфера путем вызова функции FreeContextBuffer .

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

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

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

Комментарии

Значение Flags NO_LONG_NAMES обеспечивает совместимость с Microsoft NTLM.

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

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

Требования

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

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

FreeContextBuffer

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize