Fonction LsaConnectUntrusted (ntsecapi.h)

La fonction LsaConnectUntrusted établit une connexion non approuvée au serveur LSA.

Syntaxe

NTSTATUS LsaConnectUntrusted(
  [out] PHANDLE LsaHandle
);

Paramètres

[out] LsaHandle

Pointeur vers un handle qui reçoit le handle de connexion, qui doit être fourni dans les services d’authentification futurs.

Valeur retournée

Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.

Si la fonction échoue, la valeur de retour est un code NTSTATUS. Pour plus d’informations, consultez Valeurs de retour de la fonction de stratégie LSA.

La fonction LsaNtStatusToWinError convertit un code NTSTATUS en code d’erreur Windows.

Remarques

LsaConnectUntrusted retourne un handle à une connexion non approuvée ; il ne vérifie aucune information sur l’appelant. Le handle doit être fermé à l’aide de la fonction LsaDeregisterLogonProcess .

Si votre application a simplement besoin d’interroger des informations à partir de packages d’authentification, vous pouvez utiliser le handle retourné par cette fonction dans les appels à LsaCallAuthenticationPackage et LsaLookupAuthenticationPackage.

Les applications disposant du privilège SeTcbPrivilege peuvent créer une connexion approuvée en appelant LsaRegisterLogonProcess.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ntsecapi.h
Bibliothèque	Secur32.lib
DLL	Secur32.dll

Voir aussi

LsaCallAuthenticationPackage

LsaDeregisterLogonProcess

LsaLookupAuthenticationPackage

LsaRegisterLogonProcess