Partager via


Fonction de rappel KspVerifySignatureFn (ntsecpkg.h)

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

Voir aussi

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpMakeSignature

SpUserModeInitialize

VerifySignature