As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
NCryptVerifySignature com o provedor de armazenamento de chaves (KSP)
A função NCryptVerifySignature confirma se uma assinatura corresponde a um hash especificado.
Parâmetros
-
hKey[in] -
O identificador da chave a ser usada para descriptografar a assinatura. Você deve usar a parte da chave pública do par de chaves que foi usada para assinar os dados com NCryptSignHash.
pPaddingInfo[in, optional]-
Um ponteiro para uma estrutura contendo informações de preenchimento. O tipo de estrutura depende do valor de
dwFlags. Use esse parâmetro somente com chaves assimétricas; defina como NULL para outros tipos de chave. pbHashValue[in]-
Um ponteiro para um buffer contendo o valor de hash a ser assinado. Especifique o tamanho do buffer usando
cbHashValue. cbHashValue[in]-
O tamanho em bytes do buffer
pbHashValue. pbSignature[out]-
O endereço de um buffer contendo o hash assinado dos dados. Use NCryptSignHash para criar essa assinatura. Especifique o tamanho do buffer usando
cbSignature. cbSignature[in]-
O tamanho em bytes do buffer
pbSignature. Use NCryptSignHash para criar a assinatura. dwFlags[in]-
Sinalizadores para modificar o comportamento da função. Os sinalizadores permitidos dependem do seu tipo de chave. Use um destes valores:
Valor Significado NCRYPT_PAD_ _BANDEIRA PKCS1
Indica o PKCS1 preenchimento usado na assinatura. Defina
pPaddingInfopara apontar para uma estruturaBCRYPT_PKCS1_PADDING_INFO.NCRYPT_PAD_PSS_FLAG
Indica que a assinatura usou o preenchimento Probabilistic Signature Scheme (PSS). Defina
pPaddingInfopara apontar para uma estruturaBCRYPT_PSS_PADDING_INFO.NCRYPT_SILENT_FLAG
Esse sinalizador não tem efeito.
Valor de retorno
A função retorna um código de status para indicar êxito ou falha.
Os códigos de retorno comuns incluem:
| Código de retorno | Description |
|---|---|
|
ERROR_SUCCESS |
A operação foi concluída com êxito. |
|
NTE_INVALID_PARAMETER |
Um ou mais parâmetros não são válidos. |
|
NTE_FAIL |
A operação não foi concluída. |
|
NTE_INVALID_HANDLE |
O identificador em |
|
NTE_BAD_FLAGS |
O parâmetro |
|
NTE_BAD_SIGNATURE |
A assinatura não foi verificada. |
|
NTE_BAD_KEY_STATE |
O estado da chave não é válido. |
|
NTE_INTERNAL_ERROR |
Ocorreu um erro interno ao verificar a assinatura. |
