Compartilhar via


Função SslVerifySignature

A função SslVerifySignature verifica a assinatura especificada usando o hash fornecido e a chave pública.

Sintaxe

SECURITY_STATUS WINAPI SslVerifySignature(
  _In_ NCRYPT_PROV_HANDLE hSslProvider,
  _In_ NCRYPT_KEY_HANDLE  hPublicKey,
  _In_ PBYTE              pbHashValue,
  _In_ DWORD              cbHashValue,
  _In_ PBYTE              pbSignature,
  _In_ DWORD              cbSignature,
  _In_ DWORD              dwFlags
);

Parâmetros

hSslProvider [in]

O identificador para a instância do provedor de protocolo SSL .

hPublicKey [in]

O identificador para a chave pública.

pbHashValue [in]

Um ponteiro para um buffer que contém o hash a ser usado para verificar a assinatura.

cbHashValue [in]

O tamanho, em bytes, do buffer pbHashValue .

pbSignature [in]

Um ponteiro para um buffer que contém a assinatura a ser verificada.

cbSignature [in]

O tamanho, em bytes, do buffer pbSignature .

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.

Comentários

A função SslVerifySignature não é chamada atualmente pelo Windows. Essa função é uma parte necessária da interface do Provedor SSL e deve ser totalmente implementada para garantir a compatibilidade futura.

As implementações atuais do lado do servidor da conexão TLS ( protocolo TLS) chamam a função NCryptVerifySignature durante a autenticação do cliente para processar a mensagem de verificação de certificado.

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