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/AP 必须实现 SpGetUserInfo 函数;但是，为实现提供的实际名称由开发人员决定。

从 SpLsaModeInitialize 函数接收的 SECPKG_FUNCTION_TABLE 结构中提供了指向 SpGetUserInfo 函数的指针。