SslVerifySignature, fonction

La fonction SslVerifySignature vérifie la signature spécifiée à l’aide du hachage et de la clé publique fournis.

Syntaxe

SECURITY_STATUS WINAPI SslVerifySignature(
  _In_ NCRYPT_PROV_HANDLE hSslProvider,
  _In_ NCRYPT_KEY_HANDLE  hPublicKey,
  _In_ PBYTE              pbHashValue,
  _In_ DWORD              cbHashValue,
  _In_ PBYTE              pbSignature,
  _In_ DWORD              cbSignature,
  _In_ DWORD              dwFlags
);

Paramètres

hSslProvider [in]

Handle du fournisseur de protocole SSL (Secure Sockets Layer Protocol) instance.

hPublicKey [in]

Handle de la clé publique.

pbHashValue [in]

Pointeur vers une mémoire tampon qui contient le hachage à utiliser pour vérifier la signature.

cbHashValue [in]

Taille, en octets, de la mémoire tampon pbHashValue .

pbSignature [in]

Pointeur vers une mémoire tampon qui contient la signature à vérifier.

cbSignature [in]

Taille, en octets, de la mémoire tampon pbSignature .

dwFlags [in]

Ce paramètre est réservé à un usage futur.

Valeur retournée

Si la fonction réussit, elle retourne zéro.

Si la fonction échoue, elle retourne une valeur d’erreur différente de zéro.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code/valeur de retour	Description
NTE_INVALID_HANDLE 0x80090026L	L’un des handles fournis n’est pas valide.

Notes

La fonction SslVerifySignature n’est actuellement pas appelée par Windows. Cette fonction est une partie obligatoire de l’interface du fournisseur SSL et doit être entièrement implémentée pour garantir la compatibilité ascendante.

Les implémentations actuelles du côté serveur de la connexion TLS ( Transport Layer Security Protocol ) appellent la fonction NCryptVerifySignature pendant l’authentification du client pour traiter le message de vérification du certificat.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Sslprovider.h
DLL	Ncrypt.dll