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.

Valore	Significato
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT 0x00000001	Impostare questo flag per creare un nodo Object e aggiungerlo all'elemento Signature . Un riferimento al nodo Object viene creato nell'elemento SignedInfo . L'handle restituito è un nodo Object incapsulato e può essere usato nelle chiamate successive alla funzione CryptXmlCreateReference per creare riferimenti nel nodo Manifesto .

[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

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	cryptxml.h
Libreria	Cryptxml.lib
DLL	Cryptxml.dll