Méthode IXpsSignatureManager ::AddSignatureBlock (xpsdigitalsignature.h)

Crée une interface IXpsSignatureBlock et l’ajoute à la collection de blocs de signature.

Syntaxe

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

Paramètres

[in] partName

Pointeur vers l’interface IOpcPartUri qui contient l’URI du nouveau composant. Pour que la méthode génère un nom de partie, ce paramètre peut être défini sur NULL.

[in] fixedDocumentIndex

Valeur d’index de la partie FixedDocument à laquelle le nouveau bloc de signature doit être associé.

[out, retval] signatureBlock

Pointeur vers la nouvelle interface IXpsSignatureBlock . Si l’accès à la nouvelle interface n’est pas requis, ce paramètre peut être défini sur NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles de la table qui suit. Pour connaître les valeurs de retour qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de l’API signature numérique XPS et Erreurs de document XPS.

Remarques

Un bloc de signature représente une partie SignatureDefinitions dans un package XPS. Selon la section 10.2.2 de la spécification de papier XML, aucune ou plusieurs parties SignatureDefinitions peuvent être attachées à chaque FixedDocument. Cette méthode crée un composant SignatureDefinitions avec le nom spécifié, le lie à partir du composant FixedDocument spécifié par une relation, crée une interface IXpsSignatureBlock et ajoute cette nouvelle interface à la collection de blocs de signature interne.

Pour récupérer un bloc de signature, appelez la méthode GetSignatureBlocks .

Configuration requise

Voir aussi

IOpcPartUri

IXpsSignatureBlock

IXpsSignatureManager

XML Paper Specification

Erreurs de l’API signature numérique XPS

Erreurs de document XPS