Partager via


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

Voir aussi

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize

SpVerifySignature