GetSecurityUserInfo 函式 (ntifs.h)

  • 發行項

GetSecurityUserInfo 函式會擷取登入會話的相關信息。

語法

NTSTATUS SEC_ENTRY GetSecurityUserInfo(
  [in, optional] PLUID             LogonId,
  [in]           ULONG             Flags,
  [out]          PSecurityUserData *UserInformation
);

參數

[in, optional] LogonId

LUID 的選擇性指標，其中包含要擷取資訊的登入會話。 如果 LogonId 為 NULL，則會傳回呼叫線程登入會話的資訊。

[in] Flags

目前未使用這個參數。

[out] UserInformation

位置的指標，其中包含 SecurityUserData 結構的指標。 如果函式呼叫成功，則會在此結構中傳回用戶資訊。 呼叫端負責呼叫 LsaFreeReturnBuffer 函式來釋放此緩衝區。

傳回值

GetSecurityUserInfo 會傳回適當的 NTSTATUS 值，例如下列其中一個值。

傳回碼 Description
STATUS_SUCCESS
 UserInformation 間接指向的 SecurityUserData 結構包含所要求的用戶資訊。
STATUS_NO_SUCH_LOGON_SESSION
 表示指定的登入會話不存在。

備註

此函式會透過 SecurityUserData 結構取得登入工作階段的相關信息。

規格需求

需求 值
最低支援的用戶端 Windows 2000
目標平台 Universal
標頭 ntifs.h (包括 Ntifs.h、FltKernel.h)
程式庫 Ksecdd.lib
IRQL PASSIVE_LEVEL

另請參閱

LsaFreeReturnBuffer

MapSecurityError