Partager via


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
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