IXpsSignatureManager::AddSignatureBlock-Methode (xpsdigitalsignature.h)

Artikel
03/13/2024

Erstellt eine neue IXpsSignatureBlock-Schnittstelle und fügt sie der Signaturblockauflistung hinzu.

Syntax

HRESULT AddSignatureBlock(
  [in]          IOpcPartUri        *partName,
  [in]          UINT32             fixedDocumentIndex,
  [out, retval] IXpsSignatureBlock **signatureBlock
);

Parameter

[in] partName

Ein Zeiger auf die IOpcPartUri-Schnittstelle , die den URI des neuen Teils enthält. Damit die Methode einen Teilenamen generiert, kann dieser Parameter auf NULL festgelegt werden.

[in] fixedDocumentIndex

Der Indexwert des FixedDocument-Teils, dem der neue Signaturblock zugeordnet werden soll.

[out, retval] signatureBlock

Ein Zeiger auf die neue IXpsSignatureBlock-Schnittstelle . Wenn kein Zugriff auf die neue Schnittstelle erforderlich ist, kann dieser Parameter auf NULL festgelegt werden.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	fixedDocumentIndex verweist auf ein festes Dokument, das nicht im XPS-Paket gefunden wird.
XPS_E_PACKAGE_NOT_OPENED	Im Signatur-Manager wurde noch kein XPS-Paket geöffnet.

Hinweise

Ein Signaturblock stellt einen SignatureDefinitions-Teil in einem XPS-Paket dar. Gemäß Abschnitt 10.2.2 der XML-Papierspezifikation können an jedes FixedDocument keine oder mehr SignatureDefinitions-Teile angefügt werden. Diese Methode erstellt einen neuen SignatureDefinitions-Teil mit dem angegebenen Namen, verknüpft es mit dem angegebenen FixedDocument-Teil durch eine Beziehung, erstellt eine neue IXpsSignatureBlock-Schnittstelle und fügt diese neue Schnittstelle der internen Signaturblocksammlung hinzu.

Rufen Sie zum Abrufen eines Signaturblocks die GetSignatureBlocks-Methode auf.

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