LSA_OPEN_SAM_USER fonction de rappel (ntsecpkg.h)
Récupère un handle pour un compte d’utilisateur dans la base de données du Gestionnaire des comptes de sécurité (SAM).
Syntaxe
LSA_OPEN_SAM_USER LsaOpenSamUser;
NTSTATUS LsaOpenSamUser(
[in] PSECURITY_STRING Name,
[in] SECPKG_NAME_TYPE NameType,
[in] PSECURITY_STRING Prefix,
[in] BOOLEAN AllowGuest,
[in] ULONG Reserved,
[out] PVOID *UserHandle
)
{...}
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 |
---|---|
|
Le nom est compatible avec sam. Un exemple de nom au format compatible SAM est « ExampleDomain\Username ». |
|
Le nom se trouve dans la propriété AltSecId du compte SAM. Cette valeur est utilisée avec le paramètre Prefix . |
|
Nom est un nom de compte de type UPN (nom d’utilisateur principal ) 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 spécifie le préfixe à utiliser avec des noms qui utilisent un NameType de SecNameAlternateId.
[in] AllowGuest
Spécifie s’il faut utiliser le compte Invité si le compte SAM est introuvable. Ce paramètre peut prendre les valeurs suivantes.
[in] Reserved
Réservé. Spécifiez zéro.
[out] UserHandle
Pointeur vers un pointeur qui reçoit un handle vers le compte d’utilisateur.
Valeur retournée
Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.
Si la fonction échoue, la valeur de retour est l’un des codes d’erreur NTSTATUS suivants qui indique la raison de l’échec.
Code de retour | Description |
---|---|
|
NameType est SecNameAlternateId et Prefix a la valeur NULL. |
|
Le compte SAM est introuvable. |
Remarques
Pour fermer le handle reçu par le paramètre UserHandle , appelez la fonction CloseSamUser .
Le nom unique d’un utilisateur identifie le nom, le domaine et le chemin d’accès complet à l’objet Active Directory qui représente l’utilisateur.
Un pointeur vers la fonction OpenSamUser est disponible 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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour