Fonction de rappel SpQueryContextAttributesFn (ntsecpkg.h)

Article
03/04/2024

La fonction SpQueryContextAttributes récupère les attributs d’un contexte de sécurité.

La fonction SpQueryContextAttributes est la fonction dispatch pour la fonction QueryContextAttributes (Général) de l’interface du fournisseur de support de sécurité.

Syntaxe

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

Paramètres

[in] ContextHandle

Handle pour le contexte de sécurité.

[in] ContextAttribute

Attribut de contexte à interroger. Pour obtenir la liste des valeurs valides, consultez la fonction QueryContextAttributes (Général).

[out] Buffer

Pointeur qui reçoit l’adresse d’une mémoire tampon contenant les attributs demandés. La mémoire du paramètre Buffer doit être allouée avec la fonction AllocateHeap à partir de la table de fonctions SECPKG_DLL_FUNCTIONS en mode utilisateur. En mode LSA (Local Security Authority ), utilisez la fonction AllocateLsaHeap .

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 une raison courante de l’échec et le code d’erreur que la fonction doit retourner.

Code de retour	Description
SEC_E_INVALID_HANDLE	Le handle n’est pas valide.

Remarques

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

Un pointeur vers l’implémentation en mode LSA de la fonction SpQueryContextAttributes est disponible dans la structure SECPKG_FUNCTION_TABLE reçue de la fonction SpLsaModeInitialize .

Un pointeur vers l’implémentation en mode utilisateur de la fonction SpQueryContextAttributes est disponible dans la structure SECPKG_USER_FUNCTION_TABLE reçue de la fonction SpUserModeInitialize .

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