Fonction de rappel SpQueryCredentialsAttributesFn (ntsecpkg.h)

  • Article

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