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

Artículo
03/13/2024

Crea una nueva interfaz IXpsSignatureBlock y la agrega a la colección de bloques de firmas.

Sintaxis

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

Parámetros

[in] partName

Puntero a la interfaz IOpcPartUri que contiene el URI de la nueva parte. Para que el método genere un nombre de elemento, este parámetro se puede establecer en NULL.

[in] fixedDocumentIndex

Valor de índice de la parte FixedDocument con la que se asociará el nuevo bloque de firma.

[out, retval] signatureBlock

Puntero a la nueva interfaz IXpsSignatureBlock . Si no se requiere acceso a la nueva interfaz, este parámetro se puede establecer en NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener los valores devueltos que no aparecen en esta tabla, consulte Errores de XPS Digital Signature API y Errores de documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	fixedDocumentIndex hace referencia a un documento fijo que no se encuentra en el paquete XPS.
XPS_E_PACKAGE_NOT_OPENED	Todavía no se ha abierto un paquete XPS en el administrador de firmas.

Comentarios

Un bloque de firma representa una parte SignatureDefinitions en un paquete XPS. Según la sección 10.2.2 de la Especificación de papel XML, se pueden adjuntar cero o más partes SignatureDefinitions a cada FixedDocument. Este método crea una nueva parte SignatureDefinitions con el nombre especificado, lo vincula desde la parte FixedDocument especificada por una relación, crea una nueva interfaz IXpsSignatureBlock y agrega esta nueva interfaz a la colección de bloques de firmas interna.

Para recuperar un bloque de firma, llame al método GetSignatureBlocks .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	xpsdigitalsignature.h