LSA_CREATE_LOGON_SESSION Rückruffunktion (ntsecpkg.h)

Erstellt Anmeldesitzungen.

Die Anmeldesitzung wird durch eine eindeutige Anmelde-ID ( LUID) identifiziert, die der Anmeldesitzung zugewiesen ist.

Syntax

LSA_CREATE_LOGON_SESSION LsaCreateLogonSession;

NTSTATUS LsaCreateLogonSession(
  [in] PLUID LogonId
)
{...}

Parameter

[in] LogonId

Zeiger auf eine LUID-Struktur , die der neuen Anmeldesitzung zugewiesen werden soll. Ein Authentifizierungspaket ruft AllocateLocallyUniqueId auf, um diese ID zu generieren.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code, wobei es sich um den folgenden Wert oder einen der Rückgabewerte der LSA-Richtlinienfunktion handeln kann.

Rückgabecode	Beschreibung
STATUS_LOGON_SESSION_COLLISION	Die angegebene Anmelde-ID wird bereits von einer anderen Anmeldesitzung verwendet.

 

Die LsaNtStatusToWinError-Funktion konvertiert einen NTSTATUS-Code in einen Windows-Fehlercode.

Hinweise

Wenn ein Authentifizierungspaket fehlerhafte Anmeldesitzungen erstellt und gleichzeitig bestimmt, ob der Benutzer authentifiziert werden soll, sollten sie durch Aufrufen von DeleteLogonSession gelöscht werden. Wenn bei der Authentifizierung ein Fehler auftritt, sollte das Authentifizierungspaket alle zugehörigen Anmeldesitzungen löschen.

Da Anmeldesitzungen Arbeitsspeicher im Kernel verwenden, ist es wichtig, nicht verwendete oder verworfene Anmeldesitzungen zu löschen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecpkg.h

Weitere Informationen

DeleteLogonSession

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE