CryptXmlCreateReference-Funktion (cryptxml.h)

  • Artikel

Die CryptXmlCreateReference-Funktion erstellt einen Verweis auf eine XML-Signatur.

Syntax

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
);

Parameter

[in] hCryptXml

Das Handle der XML-Signatur.

dwFlags

Gibt Flags an, die sich auf die Erstellung des Verweises auswirken.

Die aktuell definierten dwFlags-Werte werden in der folgenden Tabelle angezeigt.

Wert Bedeutung
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT
0x00000001
 Legen Sie dieses Flag fest, um einen Objektknoten zu erstellen und es dem Signature-Element hinzuzufügen. Im SignedInfo-Element wird ein Verweis auf den Knoten Object erstellt.

Das zurückgegebene Handle ist ein gekapselter Objektknoten und kann in nachfolgenden Aufrufen der CryptXmlCreateReference-Funktion verwendet werden, um Verweise im Knoten Manifest zu erstellen.

[in, optional] wszId

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Wert des ID-Attributs des Reference-Elements der Signatur enthält. Wenn dieser Parameter NULL ist, wird das ID-Attribut nicht erstellt. Wenn es sich bei diesem Parameter um eine leere Zeichenfolge handelt, wird das ID-Attribut mit leerem Wert erstellt.

[in, optional] wszURI

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Wert des URI-Attributs des Reference-Elements der Signatur enthält. Wenn es sich bei diesem Parameter um eine leere Zeichenfolge handelt, wird das URI-Attribut mit einem leeren Wert erstellt.

[in, optional] wszType

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Wert des Type-Attributs des Reference-Elements der Signatur enthält. Das Verarbeitungsmodul überprüft oder verwendet dieses Attribut nicht.

[in] pDigestMethod

Ein Zeiger auf eine CRYPT_XML_ALGORITHM-Struktur , die die digest-Methode enthält.

cTransform

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

[in] rgTransform

Ein Zeiger auf ein geordnetes Array von CRYPT_XML_ALGORITHM Strukturen, die Transformationsalgorithmen enthalten, die vor der Digestberechnung auf die Verweisdaten angewendet werden sollen.

[out] phReference

Ein Zeiger auf ein Verweishandle.

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