Funzione CryptXmlDigestReference (cryptxml.h)

  • Articolo

La funzione CryptXmlDigestReference viene usata da un'applicazione per digerire il riferimento risolto. Questa funzione applica le trasformazioni prima di aggiornare il digest.

Sintassi

HRESULT CryptXmlDigestReference(
  [in] HCRYPTXML               hReference,
       DWORD                   dwFlags,
  [in] CRYPT_XML_DATA_PROVIDER *pDataProviderIn
);

Parametri

[in] hReference

Handle di un elemento Reference .

dwFlags

Specifica i valori che controllano la modalità di applicazione delle trasformazioni da parte del processo.

Le dwFlag attualmente definite sono illustrate nella tabella seguente.

Valore Significato
CRYPT_XML_REFERENCE_DATA_TRANSFORMED
0x00000001
 Specifica che il motore di elaborazione creerà il digest senza applicare il motore della catena di trasformazioni.

[in] pDataProviderIn

Puntatore a una struttura CRYPT_XML_DATA_PROVIDER che specifica il provider di dati. La funzione CryptXmlDigestReference chiama sempre la funzione fpnClose nel provider di dati.

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.

Commenti

Quando viene impostato il flag CRYPT_XML_REFERENCE_DATA_TRANSFORMED , il motore di elaborazione aggiunge i dati ricevuti direttamente al digest senza applicare il motore della catena di trasformazione.

Nota La funzione CryptXmlDigestReference chiama sempre la funzione a cui punta il membro fpnClose della struttura CRYPT_XML_DATA_PROVIDER a cui punta il parametro pDataProviderIn .
 

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