Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
NCryptSignHashcon Key Storage Provider (KSP)
La NCryptSignHash funzione crea una firma di un valore hash.
Parametri
-
hKey[in] -
L'handle della chiave da usare per firmare l'hash.
pPaddingInfo[in, opzionale]-
Un puntatore a una struttura contenente informazioni di riempimento. Il tipo di struttura dipende dal valore.
dwFlagsUtilizzate questo parametro solo con chiavi asimmetriche; impostatelo NULL per altri tipi di chiavi. pbHashValue[in]-
Un puntatore a un buffer contenente il valore hash da firmare. Specificate la dimensione del buffer utilizzando.
cbHashValue cbHashValue[in]-
La dimensione, in byte, del
pbHashValuebuffer da firmare. pbSignature[fuori]-
L'indirizzo di un buffer per memorizzare la firma. Specificare la dimensione del buffer utilizzando.
cbSignaturePer determinare la dimensione del buffer richiesta, imposta questo parametro su. NULL La funzione memorizza la dimensione richiesta (in byte) nella posizione indicata da.
pcbResult cbSignature[in]-
La dimensione del
pbSignaturebuffer in byte. La funzione ignora questo parametro se lo è.pbSignatureNULL pcbResult[fuori]-
Un puntatore a una DWORD variabile che memorizza il numero di byte copiati nel buffer.
pbSignatureIn caso
pbSignatureaffermativoNULL, memorizza la dimensione del buffer richiesta, in byte. dwFlags[in]-
Bandiere per modificare il comportamento della funzione. I flag consentiti dipendono dal tipo di chiave. Usa uno di questi valori:
Valore Significato BCRYPT_PAD_PKCS1
Utilizza lo schema di PKCS1 imbottitura. Impostato
pPaddingInfoin modo che punti a unaBCRYPT_PKCS1_PADDING_INFOstruttura.BCRYPT_PAD_PSS
Utilizza lo schema di riempimento Probabilistic Signature Scheme (PSS). Imposta il
pPaddingInfoparametro in modo che punti a una struttura.BCRYPT_PSS_PADDING_INFONCRYPT_SILENT_FLAG
Questa bandiera non ha effetto.
Valore restituito
La funzione restituisce un codice di stato per indicare l'esito positivo o negativo.
I codici di restituzione comuni includono:
| Codice di restituzione | Descrizione |
|---|---|
|
ERROR_SUCCESS |
L'operazione è stata completata con successo. |
|
NTE_INVALID_PARAMETER |
Uno o più parametri non sono validi. |
|
NTE_FAIL |
L'operazione non è stata completata. |
|
NTE_INVALID_HANDLE |
L'handle in non |
|
NTE_BAD_FLAGS |
Il |
|
NTE_BUFFER_TOO_SMALL |
Il |
|
NTE_BAD_KEY_STATE |
Lo stato della chiave non è valido. |
|
NTE_INTERNAL_ERROR |
Si è verificato un errore interno durante la firma dell'hash. |
