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
dwFlags
valor. 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
pbHashValue
buffer 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
pbSignature
buffer 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.
pPaddingInfo
Defina para apontar para umaBCRYPT_PKCS1_PADDING_INFO
estrutura.ENCRYPT_PAD_PSS_FLAG
Indica que a assinatura usou o preenchimento Probabilistic Signature Scheme (PSS).
pPaddingInfo
Defina para apontar para umaBCRYPT_PSS_PADDING_INFO
estrutura.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. |