IXpsSignatureRequest::GetSpotLocation-Methode (xpsdigitalsignature.h)

Artikel
03/09/2024

Ruft die Seite und den Speicherort auf der Seite ab, auf der die sichtbare digitale Signatur oder die Digitale Signaturanforderung angezeigt wird.

Syntax

HRESULT GetSpotLocation(
  [out] INT32       *pageIndex,
  [out] IOpcPartUri **pagePartName,
  [out] float       *x,
  [out] float       *y
);

Parameter

[out] pageIndex

Der Indexwert des FixedPage-Teils, der die Signatur oder die Digitale Signaturanforderung enthält. Wenn für die Signaturanforderung kein Spotspeicherort angegeben ist, wird –1 zurückgegeben.

[out] pagePartName

Ein Zeiger auf eine IOpcPartUri-Schnittstelle des Teils, das die FixedPage enthält, auf der die digitale Signatur angezeigt werden soll.

[out] x

Der x-Koordinatenwert der Signaturstelle auf der Seite.

[out] y

Der y-Koordinatenwert der Signaturstelle auf der Seite.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Rückgabewerte, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS Digital Signature-API-Fehler und XPS-Dokumentfehler.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	pageIndex, pagePartName, x oder y ist NULL.
E_UNEXPECTED	Die Schnittstelle ist nicht mit dem Signatur-Manager verbunden.

Hinweise

Die Position des Signaturpunkts wird in XPS-Einheiten in der oberen linken Ecke der Seite angegeben. Es gibt 96 XPS-Einheiten pro Zoll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xpsdigitalsignature.h