LSA_GET_AUTH_DATA_FOR_USER fonction de rappel (ntsecpkg.h)
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 .
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
)
{...}
[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 |
---|---|
|
Name est compatible avec sam. Un exemple de nom au format compatible SAM est « ExampleDomain\Username ». |
|
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. |
|
Name est un nom de compte de style UPN ( User Principal Name ) plat. |
|
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.
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.
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 .
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 |