Funzione CryptXmlDigestReference (cryptxml.h)

Articolo
02/26/2024

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

Condividi tramite