Função de retorno de chamada CryptXmlDllSignData (cryptxml.h)

Artigo
02/24/2024

A função CryptXmlDllSignData assina dados.

A função CryptXmlDllSignData é exposta por meio da função CryptXmlDllGetInterface exportada.

Sintaxe

CryptXmlDllSignData Cryptxmldllsigndata;

HRESULT Cryptxmldllsigndata(
  [in]            const CRYPT_XML_ALGORITHM *pSignatureMethod,
  [in]            HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hCryptProvOrNCryptKey,
  [in]            DWORD dwKeySpec,
  [in]            const BYTE *pbInput,
  [in]            ULONG cbInput,
  [out, optional] BYTE *pbOutput,
  [in]            ULONG cbOutput,
  [out]           ULONG *pcbResult
)
{...}

Parâmetros

[in] pSignatureMethod

Um ponteiro para uma estrutura CRYPT_XML_ALGORITHM que especifica o algoritmo.

[in] hCryptProvOrNCryptKey

O identificador do CSP ( provedor de serviços criptográficos ) que cria a assinatura. Esse identificador deve ser um identificador HCRYPTPROV obtido de uma chamada para a função CryptAcquireContext ou um identificador NCRYPT_KEY_HANDLE que foi criado usando a função NCryptOpenKey . Novos aplicativos devem passar um identificador de NCRYPT_KEY_HANDLE .

[in] dwKeySpec

A chave privada a ser usada do contêiner do provedor. Essa chave pode ser AT_KEYEXCHANGE ou AT_SIGNATURE. Esse parâmetro será ignorado se um identificador de NCRYPT_KEY_HANDLE for usado no parâmetro hCryptProvOrNCryptKey .

[in] pbInput

Um ponteiro para um buffer que contém o valor de resumo a ser assinado. O parâmetro cbInput contém o tamanho desse buffer.

[in] cbInput

O tamanho, em bytes, do buffer apontado pelo parâmetro pbInput .

[out, optional] pbOutput

O endereço de um buffer para receber a assinatura produzida por essa função. O parâmetro cbOutput contém o tamanho desse buffer.

Se esse parâmetro for NULL, essa função calculará o tamanho necessário para os dados criptografados e retornará o tamanho no local apontado pelo parâmetro pcbResult .

[in] cbOutput

O tamanho, em bytes, do buffer apontado pelo parâmetro pbOutput .

[out] pcbResult

Um ponteiro para uma variável DWORD que recebe o número de bytes copiados para o buffer pbOutput . Se pbOutput for NULL, isso receberá o tamanho, em bytes, necessário para a assinatura.

Retornar valor

Se a função for bem-sucedida, a função retornará zero.

Se a função falhar, ela retornará um valor HRESULT que indica o erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	cryptxml.h

Share via