LsaConnectUntrusted-Funktion (ntsecapi.h)

Die LsaConnectUntrusted-Funktion stellt eine nicht vertrauenswürdige Verbindung mit dem LSA-Server her.

Syntax

NTSTATUS LsaConnectUntrusted(
  [out] PHANDLE LsaHandle
);

Parameter

[out] LsaHandle

Zeiger auf ein Handle, das das Verbindungshandle empfängt, das in zukünftigen Authentifizierungsdiensten bereitgestellt werden muss.

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. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.

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

Hinweise

LsaConnectUntrusted gibt ein Handle an eine nicht vertrauenswürdige Verbindung zurück. Es werden keine Informationen über den Aufrufer überprüft. Das Handle sollte mit der LsaDeregisterLogonProcess-Funktion geschlossen werden.

Wenn Ihre Anwendung lediglich Informationen aus Authentifizierungspaketen abfragen muss, können Sie das von dieser Funktion zurückgegebene Handle in Aufrufen von LsaCallAuthenticationPackage und LsaLookupAuthenticationPackage verwenden.

Anwendungen mit der SeTcbPrivilege-Berechtigung können eine vertrauenswürdige Verbindung erstellen, indem sie LsaRegisterLogonProcess 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

LsaCallAuthenticationPackage

LsaDeregisterLogonProcess

LsaLookupAuthenticationPackage

LsaRegisterLogonProcess