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 函式;不過，提供給實作的實際名稱是由開發人員決定。

SpGetUserInfo 函式的指標可在從 SpLsaModeInitialize 函式收到的SECPKG_FUNCTION_TABLE結構中使用。