Funzione SslDecryptPacket

Articolo
06/12/2023

La funzione SslDecryptPacket decrittografa un singolo pacchetto SSL ( Secure Sockets Layer Protocol ).

Sintassi

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

Parametri

hSslProvider [in]: Handle dell'istanza del provider del protocollo SSL.
hKey [in, out]: Handle per la chiave utilizzata per decrittografare il pacchetto.
pbInput [in]: Puntatore al buffer che contiene il pacchetto da decrittografare.
cbInput [in]: Lunghezza, in byte, del buffer pbInput .
pbOutput [out]: Puntatore a un buffer che contiene il pacchetto decrittografato.
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.
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, a titolo esemplificativo, quanto segue.

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

Commenti

La lunghezza del pacchetto può essere zero, ad esempio quando viene decrittografato un messaggio "HelloRequest".

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

Share via