Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
NCryptVerifySignature con el proveedor de almacenamiento de claves (KSP)
La NCryptVerifySignature función confirma si una firma coincide con un hash especificado.
Parámetros
-
hKey[en] -
El identificador de la clave que se utilizará para descifrar la firma. Debe usar la parte de clave pública del par de claves que se utilizó para firmar los datos con NCryptSignHash.
pPaddingInfo[en, opcional]-
Un puntero a una estructura que contiene información de relleno. El tipo de estructura depende del
dwFlagsvalor. Utilice este parámetro solo con claves asimétricas; establézcalo en NULL para otros tipos de claves. pbHashValue[en]-
Un puntero a un búfer que contiene el valor hash que se va a firmar. Especifique el tamaño del búfer utilizando
cbHashValue. cbHashValue[en]-
El tamaño del
pbHashValuebúfer en bytes. pbSignature[fuera]-
La dirección de un búfer que contiene el hash firmado de los datos. Se utiliza NCryptSignHashpara crear esta firma. Especifique el tamaño del búfer utilizando
cbSignature. cbSignature[en]-
El tamaño del
pbSignaturebúfer en bytes. Se utiliza NCryptSignHashpara crear la firma. dwFlags[en]-
Banderas para modificar el comportamiento de la función. Los indicadores permitidos dependen del tipo de clave. Usa uno de estos valores:
Valor Significado NCRYPT_PAD_ _FLAG PKCS1
Indica la firma utilizada como relleno. PKCS1 Se establece
pPaddingInfopara que apunte a unaBCRYPT_PKCS1_PADDING_INFOestructura.NCRYPT_PAD_PSS_FLAG
Indica que la firma utilizó el relleno del esquema de firma probabilística (PSS). Configúrelo
pPaddingInfopara que apunte a una estructura.BCRYPT_PSS_PADDING_INFONCRYPT_SILENT_FLAG
Esta bandera no tiene ningún efecto.
Valor de retorno
La función devuelve un código de estado para indicar el éxito o el fracaso.
Los códigos de devolución más comunes incluyen:
| Código de retorno | Descripción |
|---|---|
|
ERROR_SUCCESS |
La operación se completó correctamente. |
|
NTE_INVALID_PARAMETER |
Uno o varios parámetros no son válidos. |
|
NTE_FAIL |
La operación no pudo completarse. |
|
NET_INVALID_HANDLE |
El identificador no es válido. |
|
NTE_BAD_FLAGS |
El |
|
NTE_BAD_SIGNATURE |
No se ha verificado la firma. |
|
NTE_BAD_KEY_STATE |
El estado de la clave no es válido. |
|
NTE_INTERNAL_ERROR |
Se ha producido un error interno al comprobar la firma. |
