CryptXmlOpenToDecode-Funktion (cryptxml.h)

Die CryptXmlOpenToDecode-Funktion öffnet eine digitale XML-Signatur zum Decodieren und gibt das Handle des Dokumentkontexts zurück, der eine CRYPT_XML_SIGNATURE Struktur kapselt. Der Dokumentkontext kann mindestens ein Signaturelement enthalten.

Syntax

HRESULT CryptXmlOpenToDecode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
                 ULONG                                  cProperty,
  [in]           const CRYPT_XML_BLOB                   *pEncoded,
                 HCRYPTXML                              *phCryptXml
);

Parameter

[in, optional] pConfig

Der Handle der Transformationsketten-Engine. Wenn dieser Parameter NULL ist, wird eine Standard-Engine verwendet, um Transformationen anzuwenden.

dwFlags

Ein DWORD-Wert , der steuert, welche CryptXML-Erweiterungen geladen werden und ob der XML-Code serialisiert wird. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CRYPT_XML_FLAG_NO_SERIALIZE 0x80000000	Die Serialisierung wird gehemmt. Wichtig Legen Sie dieses Flag nicht fest, wenn mehrere Threads auf ein CryptXml-Objekt zugreifen. Die Serialisierung stellt einen gegenseitigen Ausschluss sicher, wenn mindestens zwei Threads versuchen, ein CryptXml-Objekt oder -Arbeitsspeicher gleichzeitig zu akzeptieren.
CRYPT_XML_FLAG_DISABLE_EXTENSIONS 0x10000000	Es werden nur Standardimplementierungen für die Signatur und den Digest verwendet. Wenn dieses Flag festgelegt ist, werden keine anderen registrierten Erweiterungen geladen.

[in] rgProperty

Ein Zeiger auf ein Array von CRYPT_XML_PROPERTY Strukturen, die zusätzliche Eigenschaften enthalten.

cProperty

Die Anzahl der Elemente im Array, auf die der rgProperty-Parameter verweist.

[in] pEncoded

Ein Zeiger auf CRYPT_XML_BLOB Struktur, die die zu decodierte Signatur enthält.

phCryptXml

Das Handle eines Document Context-Objekts. Wenn Sie die Verwendung des Handles abgeschlossen haben, lassen Sie es los, indem Sie es an die Funktion CryptXmlClose übergeben.

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.

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