Funzione SslSignHash

La funzione SslSignHash firma un hash usando la chiave privata specificata. Il processo di firma viene eseguito nel server.

Sintassi

SECURITY_STATUS WINAPI SslSignHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hPrivateKey,
  _In_  PBYTE              pbHashValue,
  _In_  DWORD              cbHashValue,
  _Out_ PBYTE              pbSignature,
  _In_  DWORD              cbSignature,
  _Out_ DWORD              *pcbResult,
  _In_  DWORD              dwFlags
);

Parametri

hSslProvider [in]

Handle per l'istanza del provider di protocollo SSL (Secure Sockets Layer Protocol).

hPrivateKey [in]

Handle della chiave privata da usare per firmare l'hash.

pbHashValue [in]

Puntatore a un buffer contenente l'hash da firmare.

cbHashValue [in]

Dimensione, in byte, del buffer pbHashValue .

pbSignature [out]

Indirizzo di un buffer che riceve la firma dell'hash. Il parametro cbSignature contiene le dimensioni di questo buffer. Per determinare le dimensioni necessarie del buffer, impostare il parametro pbSignature su NULL. Le dimensioni necessarie del buffer verranno restituite nel parametro pcbResult .

cbSignature [in]

Dimensione, in byte, del buffer pbSignature .

pcbResult [out]

Puntatore a un valore che, al completamento, contiene il numero effettivo di byte scritti nel 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, a titolo esemplificativo, quanto segue.

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

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