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 función NCryptVerifySignature confirma si una firma coincide con un hash especificado.
Parameters
-
hKey[entrada] -
El identificador de la clave que se va a usar 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[entrada, opcional]-
Un puntero a una estructura que contiene información de relleno. El tipo de estructura depende del valor
dwFlags. Utilice este parámetro solo con claves asimétricas; establézcalo en NULL para otros tipos de claves. pbHashValue[entrada]-
Un puntero a un búfer que contiene el valor hash que se va a firmar. Especifique el tamaño del búfer mediante
cbHashValue. cbHashValue[entrada]-
El tamaño del búfer
pbHashValueen bytes. pbSignature[salida]-
La dirección de un búfer que contiene el hash firmado de los datos. Utilice NCryptSignHash para crear esta firma. Especifique el tamaño del búfer mediante
cbSignature. cbSignature[entrada]-
El tamaño del búfer
pbSignatureen bytes. Utilice NCryptSignHash para crear la firma. dwFlags[entrada]-
Indicadores para modificar el comportamiento de la función. Los indicadores permitidos dependen del tipo de clave. Use uno de los siguientes valores:
Valor Significado PKCS1NCRYPT_PAD_ _FLAG
Indica la firma utilizada como relleno. PKCS1 Establezca
pPaddingInfopara que apunte a una estructuraBCRYPT_PKCS1_PADDING_INFO.NCRYPT_PAD_PSS_FLAG
Indica que la firma utilizó el relleno de esquema de firma probabilística (PSS). Establezca
pPaddingInfopara que apunte a una estructuraBCRYPT_PSS_PADDING_INFO.NCRYPT_SILENT_FLAG
Este indicador no tiene efecto.
Valor de retorno
La función devuelve un código de estado para indicar si la operación se realizó correctamente o si se produjo un error.
Los códigos de retorno comunes incluyen:
| Código de retorno | Description (Descripción) |
|---|---|
|
ERROR_SUCCESS |
La operación se completó correctamente. |
|
NTE_INVALID_PARAMETER |
Uno o más parámetros no son válidos. |
|
NTE_FAIL |
La operación no se pudo completar. |
|
NTE_INVALID_HANDLE |
El identificador en |
|
NTE_BAD_FLAGS |
El parámetro |
|
NTE_BAD_SIGNATURE |
La firma no se verificó. |
|
NTE_BAD_KEY_STATE |
El estado de la clave no es válido. |
|
NTE_INTERNAL_ERROR |
Se produjo un error interno al tratar de verificar la firma. |
