Compartilhar via


Função SslDecryptPacket

A função SslDecryptPacket descriptografa um único pacote SSL ( protocolo SSL).

Sintaxe

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

Parâmetros

hSslProvider [in]

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

hKey [in, out]

O identificador para a chave usada para descriptografar o pacote.

pbInput [in]

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

cbInput [in]

O comprimento, em bytes, do buffer pbInput .

pbOutput [out]

Um ponteiro para um buffer para conter o pacote descriptografado.

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.

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.

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

Comentários

O comprimento do pacote pode ser zero, como quando uma mensagem "HelloRequest" é descriptografada.

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