Funzione SslEncryptPacket

La funzione SslEncryptPacket crittografa un singolo pacchetto SSL ( Secure Sockets Layer Protocol ).

Sintassi

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
);

Parametri

hSslProvider [in]

Handle dell'istanza del provider di protocolli SSL.

hKey [in, out]

Handle alla chiave usata per crittografare il pacchetto.

pbInput [in]

Puntatore al buffer che contiene il pacchetto da crittografare.

cbInput [in]

Lunghezza, in byte, del buffer pbInput .

pbOutput [out]

Puntatore a un buffer per ricevere il pacchetto crittografato.

cbOutput [in]

Lunghezza, byte, del buffer pbOutput .

pcbResult [out]

Numero di byte scritti nel buffer pbOutput .

SequenceNumber [in]

Numero di sequenza corrispondente a questo pacchetto.

dwContentType [in]

Tipo di contenuto che corrisponde a questo pacchetto, che specifica il protocollo di livello superiore usato per elaborare il pacchetto racchiuso.

Valore	Significato
CT_CHANGE_CIPHER_SPEC 20	Indica una modifica nella strategia di crittografia.
CT_ALERT 21	Indica che il pacchetto racchiuso contiene un avviso.
CT_HANDSHAKE 22	Indica che il pacchetto racchiuso fa parte del protocollo handshake.
CT_APPLICATIONDATA 23	Indica che il pacchetto contiene dati dell'applicazione.

dwFlags [in]

Questo parametro è riservato per usi futuri.

Valore restituito

Se la funzione ha esito positivo, restituisce zero.

Se la funzione ha esito negativo, restituisce un valore di errore diverso da zero.

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Codice/valore restituito	Descrizione
NTE_INVALID_HANDLE 0x80090026L	Uno degli handle forniti non è valido.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Sslprovider.h
DLL	Ncrypt.dll