LsaGetLogonSessionData 函式 (ntsecapi.h)

LsaGetLogonSessionData函式會擷取指定登入會話的相關資訊。

若要擷取登入會話的相關資訊，呼叫端必須是會話或本機系統管理員的擁有者。

語法

NTSTATUS LsaGetLogonSessionData(
  [in]  PLUID                        LogonId,
  [out] PSECURITY_LOGON_SESSION_DATA *ppLogonSessionData
);

[in] LogonId

指定 LUID 的指標，識別將擷取其資訊的登入會話。如需此參數有效值的相關資訊，請參閱。

[out] ppLogonSessionData

SECURITY_LOGON_SESSION_DATA結構的指標位址，其中包含LogonId所指定之登入會話的資訊。此結構是由 LSA 配置。不再需要資訊時，請呼叫 LsaFreeReturnBuffer 函式以釋放這個結構所使用的記憶體。

如果函式成功，傳回值會STATUS_SUCCESS。

如果函式失敗，傳回值為 NTSTATUS 程式碼，表示原因。

若要取得可能傳遞至此函式 LogonId 參數的有效登入會話識別碼，請呼叫 LsaEnumerateLogonSessions 函式。

如果 LogonID 指定 LocalSystem 帳戶 (0x0：0x3e7) ，則此函式會針對 ppLogonSessionData中擷取的登入會話資料傳回零。原因是 LocalSystem 帳戶不會以一般登入方式登入。相反地，LocalSystem 帳戶會在系統啟動時處於作用中狀態。