Función CryptXmlCreateReference (cryptxml.h)

Artículo
08/22/2023

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.

Valor	Significado
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT 0x00000001	Establezca esta marca para crear un nodo Object y agregarlo al elemento Signature . Se crea una referencia al nodo Object en el elemento SignedInfo . El identificador devuelto es un nodo Object encapsulado y se puede usar en llamadas posteriores a la función CryptXmlCreateReference para crear referencias en el nodo Manifiesto .

[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

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	cryptxml.h
Library	Cryptxml.lib
Archivo DLL	Cryptxml.dll