Método IXpsSignature::SetSignatureXml (xpsdigitalsignature.h)

Artículo
03/13/2024

Establece el marcado XML de la firma digital.

Sintaxis

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

Parámetros

[in] signatureXml

Marcado XML de la firma digital.

[in] count

Tamaño, en bytes, del búfer al que hace referencia signatureXml.

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_POINTER	signatureXml es NULL.
E_UNEXPECTED	La interfaz no está conectada al administrador de firmas.

Comentarios

Antes de llamar a este método, la aplicación debe comprobar que el marcado de firma es válido. Si el marcado de firma no es válido, se producirá un error en este método y no se cambiará el contenido de la parte de firma.

Advertencia

El uso de este método para crear firmas digitales podría provocar que otros métodos de esta interfaz devuelvan firmas y datos que ya no son válidos.

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