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 NCryptVerifySignature função confirma se uma assinatura corresponde a um hash especificado.
Parâmetros
-
hKey[em] -
A alça 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 NCryptSignHasho.
pPaddingInfo[em, opcional]-
Um ponteiro para uma estrutura contendo informações de preenchimento. O tipo de estrutura depende do
dwFlagsvalor. Use esse parâmetro somente com chaves assimétricas; defina como NULL para outros tipos de chave. pbHashValue[em]-
Um ponteiro para um buffer contendo o valor de hash a ser assinado. Especifique o tamanho do buffer usando
cbHashValue. cbHashValue[em]-
O tamanho do
pbHashValuebuffer em bytes. pbSignature[fora]-
O endereço de um buffer contendo o hash assinado dos dados. Use NCryptSignHashpara criar essa assinatura. Especifique o tamanho do buffer usando
cbSignature. cbSignature[em]-
O tamanho do
pbSignaturebuffer em bytes. Use NCryptSignHashpara criar a assinatura. dwFlags[em]-
Sinalizadores para modificar o comportamento da função. Os sinalizadores permitidos dependem do seu tipo de chave. Use um desses valores:
Valor Significado NCRYPT_PAD_ _BANDEIRA PKCS1
Indica o PKCS1 preenchimento usado na assinatura.
pPaddingInfoDefina para apontar para umaBCRYPT_PKCS1_PADDING_INFOestrutura.ENCRYPT_PAD_PSS_FLAG
Indica que a assinatura usou o preenchimento Probabilistic Signature Scheme (PSS).
pPaddingInfoDefina para apontar para umaBCRYPT_PSS_PADDING_INFOestrutura.ENCRYPT_SILENT_FLAG
Essa bandeira não tem efeito.
Valor de retorno
A função retorna um código de status para indicar sucesso ou falha.
Os códigos de devolução comuns incluem:
| Código de retorno | Descrição |
|---|---|
|
ERROR_SUCCESS |
A operação foi concluída com êxito. |
|
PARÂMETRO_INVÁLIDO DA NOTA |
Um ou mais parâmetros não são válidos. |
|
NOTA_FALHA |
A operação não pôde ser concluída. |
|
NOME DE USUÁRIO INVÁLIDO |
O identificador de |
|
ANOTAR BANDEIRAS_RUINS |
O |
|
ANTE_BAD_SIGNATURE |
A assinatura não foi verificada. |
|
NOTA_BAD_KEY_STATE |
O estado da chave não é válido. |
|
ANOTE O ERRO INTERNO |
Ocorreu um erro interno ao verificar a assinatura. |