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à.
NCryptSignHash con 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 su 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, impostate 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 sepbSignatureè NULL. pcbResult[fuori]-
Un puntatore a una variabile DWORD che memorizza il numero di byte copiati nel buffer.
pbSignatureSe
pbSignatureè NULL, 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 imbottitura. PKCS1 Impostato
pPaddingInfoin modo che punti a unaBCRYPT_PKCS1_PADDING_INFOstruttura.BCRYPT_PAD_PSS
Utilizza lo schema di imbottitura 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. |
|
NOTE_FAIL |
L'operazione non è stata completata. |
|
NTE_INVALID_HANDLE |
L'handle in non è valido. |
|
NET_BAD_FLAGS |
Il |
|
NET_BUFFER_TOO_SMALL |
Il |
|
NET_BAD_KEY_STATE |
Lo stato della chiave non è valido. |
|
NTE_INTERNAL_ERROR |
Si è verificato un errore interno durante la firma dell'hash. |
