Funzione SslVerifySignature

Articolo
06/12/2023

La funzione SslVerifySignature verifica la firma specificata usando l'hash fornito e la chiave pubblica.

Sintassi

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

Parametri

hSslProvider [in]: Handle per l'istanza del provider di protocollo SSL (Secure Sockets Layer Protocol).
hPublicKey [in]: Handle alla chiave pubblica.
pbHashValue [in]: Puntatore a un buffer contenente l'hash da usare per verificare la firma.
cbHashValue [in]: Dimensioni, in byte, del buffer pbHashValue .
pbSignature [in]: Puntatore a un buffer contenente la firma da verificare.
cbSignature [in]: Dimensioni, in byte, del buffer pbSignature .
dwFlags [in]: Questo parametro è riservato per usi futuri.

Valore restituito

Se la funzione ha esito positivo, restituisce zero.

Se la funzione ha esito negativo, restituisce un valore di errore diverso da zero.

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Codice/valore restituito	Descrizione
NTE_INVALID_HANDLE 0x80090026L	Uno degli handle forniti non è valido.

Commenti

La funzione SslVerifySignature non è attualmente chiamata da Windows. Questa funzione è una parte necessaria dell'interfaccia del provider SSL e deve essere completamente implementata per garantire la compatibilità con l'inoltro.

Le implementazioni correnti del lato server della connessione TLS (Transport Layer Security Protocol ) chiamano la funzione NCryptVerifySignature durante l'autenticazione client per elaborare il messaggio di verifica del certificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Sslprovider.h
DLL	Ncrypt.dll

Condividi tramite