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