Partager via


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
NO_LONG_NAMES
Le nom de domaine retourné ne peut pas dépasser 15 caractères.
UNDERSTANDS_LONG_NAMES
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

Voir aussi

FreeContextBuffer

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize