Partager via


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