Fonction de rappel SpGetUserInfoFn (ntsecpkg.h)
La fonction SpGetUserInfo récupère des informations sur une session d’ouverture de session.
Syntaxe
SpGetUserInfoFn Spgetuserinfofn;
NTSTATUS Spgetuserinfofn(
[in] PLUID LogonId,
[in] ULONG Flags,
[out] PSecurityUserData *UserData
)
{...}
Paramètres
[in] LogonId
Pointeur vers un LUID contenant la session d’ouverture de session pour laquelle les informations doivent être récupérées.
[in] Flags
Spécifie la longueur acceptable du nom de domaine comme l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Le nom de domaine retourné ne peut pas dépasser 15 caractères. |
|
Le nom de domaine retourné peut comporter plus de 15 caractères. |
[out] UserData
Pointeur vers un pointeur vers une structure SecurityUserData . Si l’appel de fonction réussit, les informations utilisateur sont retournées dans cette structure. Le package de sécurité doit allouer la mémoire pour cette structure dans l’espace d’adressage de l’appelant. L’appelant est responsable de libérer la mémoire tampon en appelant la fonction FreeContextBuffer .
Valeur retournée
Si la fonction réussit, retournez STATUS_SUCCESS.
Si la fonction échoue, retourne un code NTSTATUS qui indique la raison de son échec.
Remarques
La valeur Flags NO_LONG_NAMES fournit la compatibilité avec Microsoft NTLM.
Les fournisseurs de services partagés/fournisseurs d’accès doivent implémenter la fonction SpGetUserInfo ; toutefois, le nom réel donné à l’implémentation appartient au développeur.
Un pointeur vers la fonction SpGetUserInfo est disponible dans la structure SECPKG_FUNCTION_TABLE reçue de la fonction SpLsaModeInitialize .
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 |