Función SslVerifySignature

La función SslVerifySignature comprueba la firma especificada mediante el hash proporcionado y la clave pública.

Sintaxis

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]

Identificador de la instancia del proveedor del protocolo Capa de sockets seguros (SSL).

hPublicKey [in]

Identificador de la clave pública.

pbHashValue [in]

Puntero a un búfer que contiene el hash que se va a usar para comprobar la firma.

cbHashValue [in]

Tamaño, en bytes, del búfer pbHashValue .

pbSignature [in]

Puntero a un búfer que contiene la firma que se va a comprobar.

cbSignature [in]

Tamaño, en bytes, del búfer pbSignature .

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.

Observaciones

El Windows no llama actualmente a la función SslVerifySignature. Esta función es una parte necesaria de la interfaz del proveedor SSL y debe implementarse completamente para garantizar la compatibilidad directa.

Las implementaciones actuales del lado servidor del protocolo de seguridad de la capa de transporte (TLS) llaman a la función NCryptVerifySignature durante la autenticación del cliente para procesar el mensaje de comprobación del certificado.

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