SslSignHash, fonction

La fonction SslSignHash signe un hachage à l’aide de la clé privée spécifiée. Le processus de signature est effectué sur le serveur.

Syntaxe

SECURITY_STATUS WINAPI SslSignHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hPrivateKey,
  _In_  PBYTE              pbHashValue,
  _In_  DWORD              cbHashValue,
  _Out_ PBYTE              pbSignature,
  _In_  DWORD              cbSignature,
  _Out_ DWORD              *pcbResult,
  _In_  DWORD              dwFlags
);

Paramètres

hSslProvider [in]

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

hPrivateKey [in]

Handle de la clé privée à utiliser pour signer le hachage.

pbHashValue [in]

Pointeur vers une mémoire tampon qui contient le hachage à signer.

cbHashValue [in]

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

pbSignature [out]

Adresse d’une mémoire tampon qui reçoit la signature du hachage. Le paramètre cbSignature contient la taille de cette mémoire tampon. Pour déterminer la taille de taille requise de la mémoire tampon, définissez le paramètre pbSignature sur NULL. La taille requise de la mémoire tampon est retournée dans le paramètre pcbResult .

cbSignature [in]

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

pcbResult [out]

Pointeur vers une valeur qui, une fois terminée, contient le nombre réel d’octets écrits dans 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.

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