Función SslEncryptPacket

La función SslEncryptPacket cifra un único paquete de protocolo de capa de sockets seguros (SSL).

Sintaxis

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

Parámetros

hSslProvider [in]

Identificador de la instancia del proveedor de protocolo SSL.

hKey [in, out]

Identificador de la clave que se usa para cifrar el paquete.

pbInput [in]

Puntero al búfer que contiene el paquete que se va a cifrar.

cbInput [in]

Longitud, en bytes, del búfer pbInput .

pbOutput [out]

Puntero a un búfer para recibir el paquete cifrado.

cbOutput [in]

Longitud, bytes, del búfer pbOutput .

pcbResult [out]

Número de bytes escritos en el búfer pbOutput .

SequenceNumber [in]

Número de secuencia que corresponde a este paquete.

dwContentType [in]

Tipo de contenido que corresponde a este paquete, que especifica el protocolo de nivel superior que se usa para procesar el paquete incluido.

Valor	Significado
CT_CHANGE_CIPHER_SPEC 20	Indica un cambio en la estrategia de cifrado.
CT_ALERT 21	Indica que el paquete incluido contiene una alerta.
CT_HANDSHAKE 22	Indica que el paquete incluido forma parte del protocolo de protocolo de enlace.
CT_APPLICATIONDATA 23	Indica que el paquete contiene datos de aplicación.

dwFlags [in]

Este parámetro se reserva para uso futuro.

Valor devuelto

Si la función se realiza correctamente, devuelve cero.

Si se produce un error en la función, devuelve un valor de error distinto de cero.

Entre los posibles códigos de retorno se incluyen, entre otros, los siguientes.

Código o valor devuelto	Descripción
NTE_INVALID_HANDLE 0x80090026L	Uno de los identificadores proporcionados no es válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Sslprovider.h
Archivo DLL	Ncrypt.dll