Metodo IXpsSignatureManager::AddSignatureBlock (xpsdigitalsignature.h)

Articolo
03/05/2024

Crea una nuova interfaccia IXpsSignatureBlock e la aggiunge alla raccolta di blocchi di firma.

Sintassi

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

Parametri

[in] partName

Puntatore all'interfaccia IOpcPartUri che contiene l'URI della nuova parte. Affinché il metodo generi un nome di parte, questo parametro può essere impostato su NULL.

[in] fixedDocumentIndex

Valore di indice della parte FixedDocument a cui deve essere associato il nuovo blocco di firma.

[out, retval] signatureBlock

Puntatore alla nuova interfaccia IXpsSignatureBlock . Se l'accesso alla nuova interfaccia non è obbligatorio, questo parametro può essere impostato su NULL.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella tabella che segue. Per i valori restituiti non elencati in questa tabella, vedere Errori dell'API firma digitale XPS e errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	fixedDocumentIndex fa riferimento a un documento fisso non trovato nel pacchetto XPS.
XPS_E_PACKAGE_NOT_OPENED	Un pacchetto XPS non è ancora stato aperto nel gestore firme.

Commenti

Un blocco di firma rappresenta una parte SignatureDefinitions in un pacchetto XPS. In base alla sezione 10.2.2 nella specifica xml paper, è possibile allegare zero o più parti SignatureDefinitions a ogni FixedDocument. Questo metodo crea una nuova parte SignatureDefinitions con il nome specificato, lo collega dalla parte FixedDocument specificata da una relazione, crea una nuova interfaccia IXpsSignatureBlock e aggiunge questa nuova interfaccia all'insieme di blocchi di firma interno.

Per recuperare un blocco di firma, chiamare il metodo GetSignatureBlocks .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	xpsdigitalsignature.h