LsaGetLogonSessionData-Funktion (ntsecapi.h)

  • Artikel

Die LsaGetLogonSessionData-Funktion ruft Informationen zu einer angegebenen Anmeldesitzung ab.

Um Informationen zu einer Anmeldesitzung abzurufen, muss der Aufrufer der Besitzer der Sitzung oder ein lokaler Systemadministrator sein.

Syntax

NTSTATUS LsaGetLogonSessionData(
  [in]  PLUID                        LogonId,
  [out] PSECURITY_LOGON_SESSION_DATA *ppLogonSessionData
);

Parameter

[in] LogonId

Gibt einen Zeiger auf eine LUID an, die die Anmeldesitzung identifiziert, deren Informationen abgerufen werden. Informationen zu gültigen Werten für diesen Parameter finden Sie unter Hinweise.

[out] ppLogonSessionData

Adresse eines Zeigers auf eine SECURITY_LOGON_SESSION_DATA-Struktur , die Informationen zur Anmeldesitzung enthält, die durch LogonId angegeben wird. Diese Struktur wird vom LSA zugeordnet. Wenn die Informationen nicht mehr benötigt werden, rufen Sie die LsaFreeReturnBuffer-Funktion auf, um den von dieser Struktur verwendeten Arbeitsspeicher freizugeben.

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 , der den Grund angibt.

Hinweise

Rufen Sie die LsaEnumerateLogonSessions-Funktion auf, um gültige Anmeldesitzungsbezeichner zu erhalten, die an den LogonId-Parameter dieser Funktion übergeben werden können.

Wenn LogonID das LocalSystem-Konto (0x0:0x3e7) angibt, gibt diese Funktion null für die Anmeldesitzungsdaten zurück, die in ppLogonSessionData abgerufen werden. Der Grund ist, dass das LocalSystem-Konto nicht in der typischen Anmeldeweise angemeldet wird. Stattdessen ist das LocalSystem-Konto nach dem Start des Systems aktiv.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecapi.h
Bibliothek Secur32.lib
DLL Secur32.dll