Fonction de rappel SpGetCredentialsFn (ntsecpkg.h)

Article
03/04/2024

La fonction SpGetCredentials récupère les informations d’identification primaires et supplémentaires de l’objet utilisateur.

Syntaxe

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

Paramètres

[in] CredentialHandle

Handle des informations d’identification à récupérer.

[out] Credentials

Pointeur vers une structure SecBuffer qui reçoit les informations d’identification.

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retournez un code NTSTATUS indiquant la raison de son échec. La liste suivante répertorie les raisons courantes de l’échec et les codes d’erreur que la fonction doit retourner.

Code de retour	Description
SEC_E_INSUFFICIENT_MEMORY	La mémoire est insuffisante pour récupérer les informations d’identification.
SEC_E_INVALID_HANDLE	Le handle n’est pas valide.

Remarques

Les fournisseurs de services partagés/fournisseurs d’accès doivent implémenter la fonction SpGetCredentials ; toutefois, le nom réel donné à l’implémentation appartient au développeur.

Un pointeur vers la fonction SpGetCredentials 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

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize

Partager via