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.
NCryptSignHash con el proveedor de almacenamiento de claves (KSP)
La NCryptSignHash función crea una firma de un valor hash.
Parámetros
-
hKey[en] -
El identificador de la clave que se utilizará para firmar el hash.
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, en bytes, del
pbHashValuebúfer que se va a firmar. pbSignature[fuera]-
La dirección de un búfer para almacenar la firma. Especifique el tamaño del búfer utilizando
cbSignature.Para determinar el tamaño de búfer requerido, defina este parámetro en NULL. La función almacena el tamaño requerido (en bytes) en la ubicación indicada por
pcbResult. cbSignature[en]-
El tamaño del
pbSignaturebúfer en bytes. La función ignora este parámetro sipbSignaturees NULL. pcbResult[fuera]-
Un puntero a una variable DWORD que almacena el número de bytes copiados en el
pbSignaturebúfer.Si
pbSignaturees NULL, almacena el tamaño de búfer requerido, en bytes. 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 BCRYPT_PAD_ PKCS1
Utiliza el esquema de relleno. PKCS1 Se establece
pPaddingInfopara que apunte a unaBCRYPT_PKCS1_PADDING_INFOestructura.BCRYPT_PAD_PSS
Utiliza el esquema de relleno del esquema de firma probabilística (PSS). Defina el
pPaddingInfoparámetro para 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_BUFFER_TOO_SMALL |
El |
|
NET_BAD_KEY_STATE |
El estado de la clave no es válido. |
|
NTE_INTERNAL_ERROR |
Se ha producido un error interno al firmar el hash. |
