LsaRegisterLogonProcess-Funktion (ntsecapi.h)

  • Artikel

Die LsaRegisterLogonProcess-Funktion stellt eine Verbindung mit dem LSA-Server her und überprüft, ob es sich bei dem Aufrufer um eine Anmeldeanwendung handelt.

Syntax

NTSTATUS LsaRegisterLogonProcess(
  [in]  PLSA_STRING           LogonProcessName,
  [out] PHANDLE               LsaHandle,
  [out] PLSA_OPERATIONAL_MODE SecurityMode
);

Parameter

[in] LogonProcessName

Zeiger auf eine LSA_STRING Struktur, die die Anmeldeanwendung identifiziert. Dies sollte ein druckbarer Name sein, der für die Anzeige für Administratoren geeignet ist. Beispielsweise kann die Windows-Anmeldeanwendung den Namen "User32LogonProcess" verwenden. Dieser Name wird von der LSA während der Überwachung verwendet. LsaRegisterLogonProcess überprüft nicht, ob der Name bereits verwendet wird.

Diese Zeichenfolge darf 127 Bytes nicht überschreiten.

[out] LsaHandle

Zeiger, der ein Handle empfängt, das in zukünftigen Authentifizierungsfunktionsaufrufen verwendet wird.

[out] SecurityMode

Der zurückgegebene Wert ist nicht aussagekräftig und sollte ignoriert werden.

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. Im Folgenden finden Sie mögliche Fehlercodes.

Rückgabecode Beschreibung
STATUS_PORT_CONNECTION_REFUSED
 Der Aufrufer verfügt nicht über die SeTcbPrivilege-Berechtigung, die zum Aufrufen dieser Funktion erforderlich ist.

Sie können diese Berechtigung festlegen, indem Sie LsaAddAccountRights aufrufen.
STATUS_NAME_TOO_LONG
 Der angegebene Anmeldeprozessname überschreitet 127 Bytes.
 

Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.

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

Hinweise

Diese Funktion muss aufgerufen werden, bevor ein Anmeldeprozess andere Anmeldeauthentifizierungsfunktionen verwenden kann, die von der LSA bereitgestellt werden.

Die LsaRegisterLogonProcess-Funktion überprüft, ob die Anwendung, die den Funktionsaufruf vornimmt, ein Anmeldeprozess ist, indem sie überprüft, ob die SeTcbPrivilege-Berechtigung festgelegt ist. Außerdem wird der Prozess der Anwendung für PROCESS_DUP_HANDLE Zugriff in Erwartung zukünftiger LSA-Authentifizierungsaufrufe geöffnet. Weitere Informationen finden Sie unter DuplicateHandle.

Wenn Sie die Verbindung mit dem LSA-Server hergestellt haben, löschen Sie den Anmeldeanwendungskontext des Aufrufers, und schließen Sie die Verbindung, indem Sie die LsaDeregisterLogonProcess-Funktion aufrufen.

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 ntsecapi.h
Bibliothek Secur32.lib
DLL Secur32.dll

Weitere Informationen

LsaAddAccountRights

LsaConnectUntrusted

LsaDeregisterLogonProcess