Función CryptXmlCreateReference (cryptxml.h)

La función CryptXmlCreateReference crea una referencia a una firma XML.

Sintaxis

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

Identificador de la firma XML.

dwFlags

Especifica marcas que afectan a cómo se crea la referencia.

Los valores dwFlags definidos actualmente se muestran en la tabla siguiente.

[in, optional] wszId

Puntero a una cadena Unicode terminada en null que contiene el valor del atributo ID del elemento Reference de la firma. Si este parámetro es NULL, no se crea el atributo ID . Si este parámetro es una cadena vacía, se crea el atributo ID con un valor vacío.

[in, optional] wszURI

Puntero a una cadena Unicode terminada en null que contiene el valor del atributo URI del elemento Reference de la firma. Si este parámetro es una cadena vacía, se crea el atributo URI con un valor vacío.

[in, optional] wszType

Puntero a una cadena Unicode terminada en null que contiene el valor del atributo Type del elemento Reference de la firma. El motor de procesamiento no comprueba ni usa este atributo.

[in] pDigestMethod

Puntero a una estructura CRYPT_XML_ALGORITHM que contiene el método digest.

cTransform

Número de elementos de la matriz a los que apunta el parámetro rgTransform .

[in] rgTransform

Puntero a una matriz ordenada de estructuras de CRYPT_XML_ALGORITHM que contienen algoritmos de transformación que se van a aplicar a los datos de referencia antes del cálculo de resumen.

[out] phReference

Puntero a un identificador de referencia.

Valor devuelto

Si la función se realiza correctamente, la función devuelve cero.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error.

Requisitos