GetSecurityUserInfo-Funktion (ntifs.h)

  • Artikel

Die GetSecurityUserInfo-Funktion ruft Informationen zu einer Anmeldesitzung ab.

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 LogonIdNULL 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 einen Speicherort, der einen Zeiger auf eine SecurityUserData-Struktur enthält. Wenn der Funktionsaufruf erfolgreich ist, werden die Benutzerinformationen in dieser Struktur zurückgegeben. Der Aufrufer ist für das Freigeben dieses Puffers durch Aufrufen der LsaFreeReturnBuffer-Funktion verantwortlich.

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 von UserInformation verwiesen wird, enthält die angeforderten Benutzerinformationen.
STATUS_NO_SUCH_LOGON_SESSION
 Gibt an, dass die angegebene Anmeldesitzung nicht vorhanden ist.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000
Zielplattform Universell
Header ntifs.h (include Ntifs.h, FltKernel.h)
Bibliothek Ksecdd.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

LsaFreeReturnBuffer

MapSecurityError