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 |
---|---|
|
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 |