LSA_OPEN_SAM_USER fonction de rappel (ntsecpkg.h)

Article
02/29/2024

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
SecNameSamCompatible	Le nom est compatible avec sam. Un exemple de nom au format compatible SAM est « ExampleDomain\Username ».
SecNameAlternateId	Le nom se trouve dans la propriété AltSecId du compte SAM. Cette valeur est utilisée avec le paramètre Prefix .
SecNameFlat	Nom est un nom de compte de type UPN (nom d’utilisateur principal ) 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 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.

Valeur	Signification
FALSE	Si l’utilisateur est introuvable, l’appel de fonction OpenSamUser échoue.
TRUE	Si l’utilisateur est introuvable et que le compte Invité est activé, le compte Invité est utilisé.

[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
STATUS_INVALID_PARAMETER	NameType est SecNameAlternateId et Prefix a la valeur NULL.
STATUS_NO_SUCH_USER	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

CloseSamUser

LSA_SECPKG_FUNCTION_TABLE

SpInitialize

Partager via