NCryptSignHash com o provedor de armazenamento de chaves (KSP) - AWS CloudHSM
ParâmetrosValor de retorno

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á.

NCryptSignHash com o provedor de armazenamento de chaves (KSP)

A NCryptSignHash função cria uma assinatura de um valor de hash.

Parâmetros

hKey[em]

A alça da chave a ser usada para assinar o hash.

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 usandocbHashValue.

cbHashValue[em]

O tamanho, em bytes, do pbHashValue buffer a ser assinado.

pbSignature[fora]

O endereço de um buffer para armazenar a assinatura. Especifique o tamanho do buffer usandocbSignature.

Para determinar o tamanho do buffer necessário, defina esse parâmetro como NULL. A função armazena o tamanho necessário (em bytes) no local apontado porpcbResult.

cbSignature[em]

O tamanho do pbSignature buffer em bytes. A função ignora esse parâmetro se pbSignature for NULL.

pcbResult[fora]

Um ponteiro para uma variável DWORD que armazena o número de bytes copiados para o buffer. pbSignature

Se pbSignature for NULL, isso armazenará o tamanho do buffer necessário, em bytes.

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

BCRYPT_PAD_ PKCS1

Usa o esquema PKCS1 de preenchimento. pPaddingInfoDefina para apontar para uma BCRYPT_PKCS1_PADDING_INFO estrutura.

BCRYPT_PAD_PSS

Usa o esquema de preenchimento do Probabilistic Signature Scheme (PSS). Defina o pPaddingInfo parâmetro para apontar para uma BCRYPT_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 hKey entrada não é válido.

ANOTAR BANDEIRAS_RUINS

O dwFlags parâmetro contém um valor inválido.

NOTE QUE O BUFFER É MUITO PEQUENO

O pcbOutput parâmetro é muito pequeno para valores de retorno.

NOTA_BAD_KEY_STATE

O estado da chave não é válido.

ANOTE O ERRO INTERNO

Ocorreu um erro interno ao assinar o hash.