Fonction de rappel KspVerifySignatureFn (ntsecpkg.h)

Article
02/29/2024

Vérifie que le message reçu est correct en fonction de la signature.

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

Syntaxe

KspVerifySignatureFn Kspverifysignaturefn;

NTSTATUS Kspverifysignaturefn(
        LSA_SEC_HANDLE ContextId,
  [in]  PSecBufferDesc Message,
  [in]  ULONG MessageSeqNo,
  [out] PULONG pfQOP
)
{...}

Paramètres

ContextId

[in] Message

Pointeur vers une structure SecBufferDesc contenant le message à vérifier.

[in] MessageSeqNo

Numéro de séquence à affecter au message. Les numéros de séquence sont facultatifs et sont utilisés comme protection contre la perte et l’insertion de messages. La valeur zéro indique que les numéros de séquence ne sont pas utilisés.

[out] pfQOP

Pointeur vers des indicateurs spécifiques au package qui indiquent la qualité de la protection.

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. Le tableau suivant 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

La signature vérifiée par la fonction SpVerifySignature est créée par la fonction SpMakeSignature , utilisée par un expéditeur de message.

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

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