SslEncryptPacket, fonction

La fonction SslEncryptPacket chiffre un seul paquet SSL ( Secure Sockets Layer Protocol ).

Syntaxe

SECURITY_STATUS WINAPI SslEncryptPacket(
  _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              dwContentType,
  _In_    DWORD              dwFlags
);

Paramètres

hSslProvider [in]

Handle du fournisseur de protocole SSL instance.

hKey [in, out]

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

pbInput [in]

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

cbInput [in]

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

pbOutput [out]

Pointeur vers une mémoire tampon pour recevoir le paquet 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.

dwContentType [in]

Type de contenu qui correspond à ce paquet, qui spécifie le protocole de niveau supérieur utilisé pour traiter le paquet inclus.

Valeur	Signification
CT_CHANGE_CIPHER_SPEC 20	Indique une modification de la stratégie de chiffrement.
CT_ALERT 21	Indique que le paquet inclus contient une alerte.
CT_HANDSHAKE 22	Indique que le paquet inclus fait partie du protocole d’établissement d’une liaison.
CT_APPLICATIONDATA 23	Indique que le paquet contient des données d’application.

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