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

Artículo
03/05/2024

Obtiene 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 GetSpotLocation(
  [out] INT32       *pageIndex,
  [out] IOpcPartUri **pagePartName,
  [out] float       *x,
  [out] float       *y
);

Parámetros

[out] pageIndex

Valor de índice del elemento FixedPage que contiene la firma o la solicitud de firma digital. Si no se especifica una ubicación de acceso puntual para la solicitud de firma, se devuelve –1.

[out] pagePartName

Puntero a una interfaz IOpcPartUri de la parte que contiene fixedPage en la que se va a mostrar la firma digital.

[out] x

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

[out] 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_POINTER	pageIndex, pagePartName, x o y es NULL.
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

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