Fonction de rappel KspMakeSignatureFn (ntsecpkg.h)
La fonction SpMakeSignature génère une signature basée sur le message et le contexte de sécurité spécifiés.
La fonction SpMakeSignature est la fonction dispatch pour la fonction MakeSignature de l’interface du fournisseur de support de sécurité.
Syntaxe
KspMakeSignatureFn Kspmakesignaturefn;
NTSTATUS Kspmakesignaturefn(
[in] LSA_SEC_HANDLE ContextId,
[in] ULONG fQOP,
[in] PSecBufferDesc Message,
[in] ULONG MessageSeqNo
)
{...}
Paramètres
[in] ContextId
Handle du contexte de sécurité à utiliser pour générer la signature du message.
[in] fQOP
Spécifie des indicateurs spécifiques au package qui indiquent la qualité de la protection. Un package de sécurité peut utiliser ce paramètre pour prendre en charge la sélection d’algorithmes de chiffrement
[in] Message
Pointeur vers une structure SecBuffer . Lors de l’entrée, la structure contient le message à signer.
[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.
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 |
|---|---|
|
Le handle n’est pas valide. |
Remarques
L’équivalent de la fonction SpMakeSignature est la fonction SpVerifySignature , utilisée pour vérifier les signatures à l’extrémité de réception.
SSP/APs doivent implémenter la fonction SpMakeSignature ; toutefois, le nom réel donné à l’implémentation appartient au développeur.
Un pointeur vers la fonction SpMakeSignature 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 |