Share via


Fonction de rappel SpGetCredentialsFn (ntsecpkg.h)

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