Função SslEncryptPacket

Artigo
06/13/2023

A função SslEncryptPacket criptografa um único pacote de protocolo SSL.

Sintaxe

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]

O identificador da instância do provedor de protocolo SSL.

hKey [in, out]

O identificador para a chave usada para criptografar o pacote.

pbInput [in]

Um ponteiro para o buffer que contém o pacote a ser criptografado.

cbInput [in]

O comprimento, em bytes, do buffer pbInput .

pbOutput [out]

Um ponteiro para um buffer para receber o pacote criptografado.

cbOutput [in]

O comprimento, bytes, do buffer pbOutput .

pcbResult [out]

O número de bytes gravados no buffer pbOutput .

SequenceNumber [in]

O número de sequência que corresponde a esse pacote.

dwContentType [in]

O tipo de conteúdo que corresponde a esse pacote, que especifica o protocolo de nível superior usado para processar o pacote incluído.

Valor	Significado
CT_CHANGE_CIPHER_SPEC 20	Indica uma alteração na estratégia de codificação.
CT_ALERT 21	Indica que o pacote incluído contém um alerta.
CT_HANDSHAKE 22	Indica que o pacote incluído faz parte do protocolo de handshake.
CT_APPLICATIONDATA 23	Indica que o pacote contém dados do aplicativo.

dwFlags [in]

Esse parâmetro é reservado para uso futuro.

Valor retornado

Se a função for bem-sucedida, ela retornará zero.

Se a função falhar, ela retornará um valor de erro diferente de zero.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código/valor de retorno	Descrição
NTE_INVALID_HANDLE 0x80090026L	Um dos identificadores fornecidos não é válido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	Sslprovider.h
DLL	Ncrypt.dll