Função CryptXmlCreateReference (cryptxml.h)

  • Artigo

A função CryptXmlCreateReference cria uma referência a uma assinatura XML.

Sintaxe

HRESULT CryptXmlCreateReference(
  [in]           HCRYPTXML                 hCryptXml,
                 DWORD                     dwFlags,
  [in, optional] LPCWSTR                   wszId,
  [in, optional] LPCWSTR                   wszURI,
  [in, optional] LPCWSTR                   wszType,
  [in]           const CRYPT_XML_ALGORITHM *pDigestMethod,
                 ULONG                     cTransform,
  [in]           const CRYPT_XML_ALGORITHM *rgTransform,
  [out]          HCRYPTXML                 *phReference
);

Parâmetros

[in] hCryptXml

O identificador da assinatura XML.

dwFlags

Especifica sinalizadores que afetam como a referência é criada.

Os valores dwFlags definidos atualmente são mostrados na tabela a seguir.

Valor Significado
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT
0x00000001
 Defina esse sinalizador para criar um nó Object e adicioná-lo ao elemento Signature . Uma referência ao nó Object é criada no elemento SignedInfo .

O identificador retornado é um nó object encapsulado e pode ser usado em chamadas subsequentes para a função CryptXmlCreateReference para criar referências no nó Manifesto .

[in, optional] wszId

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o valor do atributo ID do elemento Reference da assinatura. Se esse parâmetro for NULL, o atributo ID não será criado. Se esse parâmetro for uma cadeia de caracteres vazia, o atributo ID com valor vazio será criado.

[in, optional] wszURI

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o valor do atributo URI do elemento Reference da assinatura. Se esse parâmetro for uma cadeia de caracteres vazia, o atributo URI com um valor vazio será criado.

[in, optional] wszType

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o valor do atributo Type do elemento Reference da assinatura. O mecanismo de processamento não marcar ou usa esse atributo.

[in] pDigestMethod

Um ponteiro para uma estrutura CRYPT_XML_ALGORITHM que contém o método digest.

cTransform

O número de elementos na matriz apontada pelo parâmetro rgTransform .

[in] rgTransform

Um ponteiro para uma matriz ordenada de estruturas CRYPT_XML_ALGORITHM que contêm algoritmos de transformação a serem aplicados aos dados de referência antes do cálculo do resumo.

[out] phReference

Um ponteiro para um identificador de referência.

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
Biblioteca Cryptxml.lib
DLL Cryptxml.dll