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 |
|---|---|
|
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 |