Fonction de rappel SpQueryCredentialsAttributesFn (ntsecpkg.h)

Article
02/29/2024

La fonction SpQueryCredentialsAttributes récupère les attributs d’informations d’identification.

La fonction SpQueryCredentialsAttributes est la fonction dispatch de la fonction QueryCredentialsAttributes de l’interface du fournisseur de support de sécurité.

Syntaxe

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

Paramètres

[in] CredentialHandle

Handle pour les informations d’identification à interroger.

[in] CredentialAttribute

Attribut à interroger. Le tableau suivant répertorie les valeurs valides.

Valeur	Signification
SECPKG_CRED_ATTR_NAMES	Nom du principal associé aux informations d’identification.
SECPKG_ATTR_SUPPORTED_ALGS	Algorithmes pris en charge avec des informations d’identification particulières.
SECPKG_ATTR_CIPHER_STRENGTHS	Puissance de chiffrement minimale et maximale utilisée avec des informations d’identification.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Protocoles pris en charge avec des informations d’identification particulières.

[out] Buffer

Pointeur vers une mémoire tampon qui reçoit les attributs demandés. Allouez de la mémoire pour cette mémoire tampon à l’aide de la fonction AllocateClientBuffer , afin que l’appelant puisse la libérer en appelant la fonction FreeContextBuffer .

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retournez un code NTSTATUS qui indique 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	L'allocation de mémoire a échoué.
SEC_E_INVALID_HANDLE	Le handle d’informations d’identification n’est pas valide.

Remarques

SSP/APs doivent implémenter la fonction SpQueryCredentialsAttributes ; toutefois, le nom réel donné à l’implémentation appartient au développeur.

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