Função CryptXmlCreateReference (cryptxml.h)

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.

[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