SslDecryptPacket, fonction

La fonction SslDecryptPacket déchiffre un seul paquet SSL ( Secure Sockets Layer Protocol ).

Syntaxe

SECURITY_STATUS WINAPI SslDecryptPacket(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _Inout_ NCRYPT_KEY_HANDLE  hKey,
  _In_    PBYTE              *pbInput,
  _In_    DWORD              cbInput,
  _Out_   PBYTE              pbOutput,
  _In_    DWORD              cbOutput,
  _Out_   DWORD              *pcbResult,
  _In_    ULONGLONG          SequenceNumber,
  _In_    DWORD              dwFlags
);

Paramètres

hSslProvider [in]

Handle du fournisseur de protocole SSL instance.

hKey [in, out]

Handle de la clé utilisée pour déchiffrer le paquet.

pbInput [in]

Pointeur vers la mémoire tampon qui contient le paquet à déchiffrer.

cbInput [in]

Longueur, en octets, de la mémoire tampon pbInput .

pbOutput [out]

Pointeur vers une mémoire tampon pour contenir le paquet déchiffré.

cbOutput [in]

Longueur, octets, de la mémoire tampon pbOutput .

pcbResult [out]

Nombre d’octets écrits dans la mémoire tampon pbOutput .

SequenceNumber [in]

Numéro de séquence qui correspond à ce paquet.

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 longueur du paquet peut être égale à zéro, par exemple lorsqu’un message « HelloRequest » est déchiffré.

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