IXpsSignature::SetSignatureXml-Methode (xpsdigitalsignature.h)

Artikel
03/13/2024

Legt das XML-Markup der digitalen Signatur fest.

Syntax

HRESULT SetSignatureXml(
  [in] const UINT8 *signatureXml,
  [in] UINT32      count
);

Parameter

[in] signatureXml

Das XML-Markup der digitalen Signatur.

[in] count

Die Größe des Puffers, auf den von signatureXml verwiesen wird, in Bytes.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Rückgabewerte, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS Digital Signature API Errors and XPS Document Errors .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	signatureXml ist NULL.
E_UNEXPECTED	Die Schnittstelle ist nicht mit dem Signatur-Manager verbunden.

Hinweise

Vor dem Aufrufen dieser Methode muss die Anwendung überprüfen, ob das Signaturmarkup gültig ist. Wenn das Signaturmarkup ungültig ist, schlägt diese Methode fehl, und der Inhalt des Signaturteils wird nicht geändert.

Warnung

Die Verwendung dieser Methode zum Erstellen digitaler Signaturen kann dazu führen, dass andere Methoden dieser Schnittstelle Signaturen und Daten zurückgeben, die nicht mehr gültig sind.

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	xpsdigitalsignature.h