LSA_GET_AUTH_DATA_FOR_USER fonction de rappel (ntsecpkg.h)

Article
02/29/2024

La fonction GetAuthDataForUser récupère les informations d’authentification d’un utilisateur à partir de la base de données du Gestionnaire de comptes de sécurité (SAM) et la place dans un format approprié pour la fonction ConvertAuthDataToToken .

Syntaxe

LSA_GET_AUTH_DATA_FOR_USER LsaGetAuthDataForUser;

NTSTATUS LsaGetAuthDataForUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize,
  [out] PUNICODE_STRING UserFlatName
)
{...}

Paramètres

[in] Name

Pointeur vers une structure UNICODE_STRING qui spécifie le nom du compte SAM.

[in] NameType

Valeur d’énumération SECPKG_NAME_TYPE qui spécifie le type de nom de compte dans Nom. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
SecNameSamCompatible	Name est compatible avec sam. Un exemple de nom au format compatible SAM est « ExampleDomain\Username ».
SecNameAlternateId	Name se trouve dans la propriété AltSecId du compte SAM. Vous devez spécifier une valeur pour le paramètre Préfixe lors de l’utilisation de cette valeur.
SecNameFlat	Name est un nom de compte de style UPN ( User Principal Name ) plat.
SecNameDN	Name est le nom unique de l’objet. Pour plus d'informations, consultez la section Notes.

[in] Prefix

Pointeur vers une structure UNICODE_STRING qui contient le préfixe à utiliser pour les noms spécifiés avec secNameAlternateIdNameType.

[out] UserAuthData

Pointeur qui reçoit l’adresse des données récupérées.

[out] UserAuthDataSize

Pointeur vers un ULONG qui reçoit la taille des données récupérées.

[out] UserFlatName

Pointeur vers une structure UNICODE_STRING qui reçoit l’UPN, le cas échéant.

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 qui indique la raison de son échec.

Remarques

La fonction GetAuthDataForUser combine les fonctions OpenSamUser, GetUserAuthData et CloseSamUser en un seul appel.

Les pointeurs vers ces fonctions sont disponibles dans la structure LSA_SECPKG_FUNCTION_TABLE reçue par la fonction SpInitialize .

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	ntsecpkg.h