CryptXmlAddObject-Funktion (cryptxml.h)

Artikel
22.08.2023

Die CryptXmlAddObject-Funktion fügt das Object-Element zur Signatur im Dokumentkontext hinzu, der für die Codierung geöffnet wurde.

Syntax

HRESULT CryptXmlAddObject(
  [in]            HCRYPTXML                hSignatureOrObject,
                  DWORD                    dwFlags,
  [in, optional]  const CRYPT_XML_PROPERTY *rgProperty,
  [in]            ULONG                    cProperty,
  [in]            const CRYPT_XML_BLOB     *pEncoded,
  [out, optional] const CRYPT_XML_OBJECT   **ppObject
);

Parameter

[in] hSignatureOrObject

Das Handle einer Signatur, die von der CryptXmlOpenToEncode-Funktion zurückgegeben wird, oder das Handle eines Von der CryptXmlCreateReference-Funktion zurückgegebenen Verweises mit dem CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT-Flag .

dwFlags

Gibt Flags an, die die Art und Weise steuern, in der das Objekt hinzugefügt wird.

Derzeit definierte dwFlags-Werte werden in der folgenden Tabelle angezeigt.

Wert	Bedeutung
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE	Wenn festgelegt, wird eine In-Memory-Kopie des XML-Teils erstellt und im Object-Element eingeschlossen.

[in, optional] rgProperty

Ein Zeiger auf eine CRYPT_XML_PROPERTY-Struktur , die zusätzliche Eigenschaften angibt, die zum Decodieren des Object-Elements verwendet werden.

[in] cProperty

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

[in] pEncoded

Ein Zeiger auf eine CRYPT_XML_BLOB-Struktur , die das Object-Element enthält.

[out, optional] ppObject

Ein Zeiger auf einen Zeiger auf eine CRYPT_XML_OBJECT Struktur, um die decodierte Struktur zu empfangen. Dieser Parameter muss NULL sein, wenn der hSignatureOrObject-Parameter ein Handle für das Objekt enthält.

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 der hSignatureOrObject-Parameter ein Handle für einen Verweis angibt, der von der CryptXmlCreateReference-Funktion zurückgegeben wird, gibt der pEncoded-Parameter XML-Inhalt an, der nach dem optionalen Manifest-Element im Object-Knoten enthalten ist. Der im pEncoded-Parameter enthaltene Zeiger muss gültig sein, bis die Signatur abgeschlossen ist. Verwenden Sie andernfalls das Flag CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY , um eine Kopie im Arbeitsspeicher zu erstellen.

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

Freigeben über