GetSecurityUserInfo-Funktion (ntifs.h)

Artikel
12/21/2024

Die GetSecurityUserInfo Funktion ruft Informationen zu einer Anmeldesitzung Sitzungab.

Syntax

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

Parameter

[in, optional] LogonId

Ein optionaler Zeiger auf eine LUID-, die die Anmeldesitzung enthält, für die Informationen abgerufen werden sollen. Wenn LogonId-NULL-ist, werden Informationen für die Anmeldesitzung des aufrufenden Threads zurückgegeben.

[in] Flags

Dieser Parameter wird derzeit nicht verwendet.

[out] UserInformation

Ein Zeiger auf eine Position, die einen Zeiger auf eine SecurityUserData--Struktur enthält. Wenn der Funktionsaufruf erfolgreich ist, werden die Benutzerinformationen in dieser Struktur zurückgegeben. Der Aufrufer ist dafür verantwortlich, diesen Puffer freizuweisen, indem die LsaFreeReturnBuffer--Funktion aufgerufen wird.

Rückgabewert

GetSecurityUserInfo gibt einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die SecurityUserData-Struktur, auf die indirekt durch UserInformationverwiesen wird, enthält die angeforderten Benutzerinformationen.
STATUS_NO_SUCH_LOGON_SESSION	Gibt an, dass die angegebene Anmeldesitzung nicht vorhanden ist.

Bemerkungen

Diese Funktion ruft Informationen zu einer Anmeldung Sitzung über die SecurityUserData- Struktur ab.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h, FltKernel.h)
Library	Ksecdd.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

LsaFreeReturnBuffer

MapSecurityError-

Freigeben über