Show TOC

GET_SIGNATURESLocate this document in the navigation structure

Use

This method returns a list of all signatures in the PDF form in a table. The signature table also includes additional information about each signature. The information enables you to check the validity of the form and whether changes have been made to the form fields.

To execute this method, you require a secure connection to ADS. For more information, see the Adobe Document Services Configuration Guide .

This method does not return the signature used to certify a PDF. Use the method GET_CERTIFICATION instead.

Export parameters

  • NUMVERSIONS TYPE I

    Contains the total number of versions of the PDF.

  • SIGNATURES TYPE TFPSIGNATURE

    This table contains information about each signature in the PDF.

Selection of Parameters

Parameter

Meaning

STATUS

Validity of the signature in relation to the version where it was inserted. For the meaning of the integer values returned here, see the definitions of constants in the interface IF_FP_PDF_SECURITY_STATUS.

VERSION

The document version where the signature was inserted

MAXVERSION

The last version that contains the same data as VERSION The documents in VERSION and MAXVERSION can have different content in the signature fields, however.

CERTIFICATELIST

Table of the certificates of the signatures

Exception classes

  • CX_FP_RUNTIME_USAGE

  • CX_FP_RUNTIME_INTERNAL

Example

A form contains two signature fields, SF1 and SF2.

SF1 is set first, and then SF2.

Two outcomes are possible:

  • Case 1

    No content is modified in form fields between SF1 being set and SF2 being set.

    The value of MAXVERSION is the same for both signatures.

  • Case 2

    After SF1 has been set, one or more changes are made to form fields. SF2 is then set.

    The method GET_SIGNATURES returns different values for MAXVERSION for SF1 and SF2. The application can call GET_DIFFERENCES to find out what the differences in the form fields are.

See also:

SET_TASK_GETSIGNATURES

Signing Forms Digitally