Fonction LsaLookupAuthenticationPackage (ntsecapi.h)

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