CryptXmlDigestReference-Funktion (cryptxml.h)

Die CryptXmlDigestReference-Funktion wird von einer Anwendung verwendet, um den aufgelösten Verweis zu verarbeiten. Diese Funktion wendet Transformationen an, bevor der Digest aktualisiert wird.

Syntax

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

Parameter

[in] hReference

Das Handle eines Reference-Elements .

dwFlags

Gibt Werte an, die steuern, wie der Prozess Transformationen anwendet.

Aktuell definierte dwFlags sind in der folgenden Tabelle dargestellt.

Wert	Bedeutung
CRYPT_XML_REFERENCE_DATA_TRANSFORMED 0x00000001	Gibt an, dass die Verarbeitungs-Engine den Digest erstellt, ohne die Transformationsketten-Engine anzuwenden.

[in] pDataProviderIn

Ein Zeiger auf eine CRYPT_XML_DATA_PROVIDER-Struktur , die den Datenanbieter angibt. Die CryptXmlDigestReference-Funktion ruft immer die Funktion fpnClose für den Datenanbieter auf.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion null zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt.

Hinweise

Wenn das flag CRYPT_XML_REFERENCE_DATA_TRANSFORMED festgelegt ist, fügt die Verarbeitungs-Engine empfangene Daten direkt zum Digest hinzu, ohne die Transformationsketten-Engine anzuwenden.

Hinweis Die CryptXmlDigestReference-Funktion ruft immer die Funktion auf, auf die das fpnClose-Element der CRYPT_XML_DATA_PROVIDER Struktur verweist, auf die der pDataProviderIn-Parameter verweist.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	cryptxml.h
Bibliothek	Cryptxml.lib
DLL	Cryptxml.dll