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