Funzione CryptXmlCreateReference (cryptxml.h)

La funzione CryptXmlCreateReference crea un riferimento a una firma XML.

Sintassi

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
);

Parametri

[in] hCryptXml

Handle della firma XML.

dwFlags

Specifica i flag che influiscono sulla modalità di creazione del riferimento.

I valori dwFlags attualmente definiti sono illustrati nella tabella seguente.

[in, optional] wszId

Puntatore a una stringa Unicode con terminazione Null contenente il valore dell'attributo ID dell'elemento Reference della firma. Se questo parametro è NULL, l'attributo ID non viene creato. Se questo parametro è una stringa vuota, viene creato l'attributo ID con valore vuoto.

[in, optional] wszURI

Puntatore a una stringa Unicode con terminazione Null contenente il valore dell'attributo URI dell'elemento Reference della firma. Se questo parametro è una stringa vuota, viene creato l'attributo URI con un valore vuoto.

[in, optional] wszType

Puntatore a una stringa Unicode con terminazione Null contenente il valore dell'attributo Type dell'elemento Reference della firma. Il motore di elaborazione non controlla o usa questo attributo.

[in] pDigestMethod

Puntatore a una struttura CRYPT_XML_ALGORITHM che contiene il metodo digest.

cTransform

Numero di elementi nella matrice a cui punta il parametro rgTransform .

[in] rgTransform

Puntatore a una matrice ordinata di strutture CRYPT_XML_ALGORITHM che contengono algoritmi di trasformazione da applicare ai dati di riferimento prima del calcolo del digest.

[out] phReference

Puntatore a un handle di riferimento.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce zero.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore.

Requisiti