Partager via


Fonction de rappel SpUnsealMessageFn (ntsecpkg.h)

Déchiffre un message précédemment chiffré avec la fonction SpSealMessage .

La fonction SpUnsealMessage est la fonction de répartition de la fonction DecryptMessage (Général) de l’interface du fournisseur de support de sécurité.

Syntaxe

SpUnsealMessageFn Spunsealmessagefn;

NTSTATUS Spunsealmessagefn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  PSecBufferDesc MessageBuffers,
  [in]  ULONG MessageSequenceNumber,
  [out] PULONG QualityOfProtection
)
{...}

Paramètres

[in] ContextHandle

Handle du contexte de sécurité utilisé pour sceller le message.

[in] MessageBuffers

Pointeur vers une structure SecBufferDesc qui contient les mémoires tampons de message et une mémoire tampon de signature.

[in] MessageSequenceNumber

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 nombres de séquences ne sont pas utilisés.

[out] QualityOfProtection

Non utilisé.

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retourne un code NTSTATUS qui indique la raison de son échec.

Remarques

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

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

DecryptMessage (Général)

SECPKG_USER_FUNCTION_TABLE

SpSealMessage

SpUserModeInitialize