Freigeben über


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