Funzione SslVerifySignature

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