Método IXpsSignatureRequest::SetSpotLocation (xpsdigitalsignature.h)

Artículo
03/15/2023

Especifica la página y la ubicación de la página donde se mostrará la firma digital visible o la solicitud de firma digital.

Sintaxis

HRESULT SetSpotLocation(
  [in] INT32 pageIndex,
  [in] float x,
  [in] float y
);

Parámetros

[in] pageIndex

Valor de índice de la parte FixedPage del documento XPS que contiene la firma digital visible o la solicitud de firma digital.

Si el valor de este parámetro es –1, no se escribirá un elemento SpotLocation en el marcado SignatureDefinitions.

Si el valor de este parámetro no es –1, debe ser un número de página que exista en el elemento FixedDocument al que se adjunta el bloque de firma que contiene esta solicitud.

[in] x

Valor de coordenada x del punto de firma en la página.

[in] y

Valor de coordenada y del punto de firma de la página.

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_UNEXPECTED	La interfaz no está conectada al administrador de firmas.

Comentarios

La ubicación del punto de firma se especifica en unidades XPS desde la esquina superior izquierda de la página. Hay 96 unidades XPS por pulgada.

Requisitos


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