Fonction LsaLookupAuthenticationPackage (ntsecapi.h)

Article
02/29/2024

La fonction LsaLookupAuthenticationPackage obtient l’identificateur unique d’un package d’authentification.

Syntaxe

NTSTATUS LsaLookupAuthenticationPackage(
  [in]  HANDLE      LsaHandle,
  [in]  PLSA_STRING PackageName,
  [out] PULONG      AuthenticationPackage
);

Paramètres

[in] LsaHandle

Handle obtenu à partir d’un appel précédent à LsaRegisterLogonProcess ou LsaConnectUntrusted.

[in] PackageName

Pointeur vers une structure LSA_STRING qui spécifie le nom du package d’authentification. Le nom du package ne doit pas dépasser 127 octets. Le tableau suivant répertorie les noms des packages d’authentification fournis par Microsoft.

Valeur	Signification
MSV1_0_PACKAGE_NAME	Version ANSI du nom du package d’authentification MSV1_0.
MICROSOFT_KERBEROS_NAME_A	Version ANSI du nom du package d’authentification Kerberos.
NEGOSSP_NAME_A	Version ANSI du nom du package d’authentification Negotiate.

[out] AuthenticationPackage

Pointeur vers un ULONG qui reçoit l’identificateur du package d’authentification.

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. Voici les codes d’erreur possibles.

Code de retour	Description
STATUS_NO_SUCH_PACKAGE	Le package d’authentification spécifié est inconnu du LSA.
STATUS_NAME_TOO_LONG	Le nom du package d’authentification dépasse 127 octets.

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

L’identificateur de package d’authentification est utilisé dans les appels à des fonctions d’authentification telles que LsaLogonUser et LsaCallAuthenticationPackage.

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

LsaLogonUser

Partager via