![]() |
SignDoc SDK (C)
5.0.0
|
Information about a signature field returned by SIGNDOC_Document_getSignature(). More...
#include <SignDocSDK-c.h>
Public Member Functions | |
void | SIGNDOC_Signature_delete (struct SIGNDOC_Signature *aObj) |
SIGNDOC_Signature destructor. More... | |
char * | SIGNDOC_Signature_getFieldName (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj, int aEncoding) |
Get the name of the signature field. More... | |
const char * | SIGNDOC_Signature_getFieldNameUTF8 (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the name of the signature field as UTF-8-encoded C string. More... | |
int | SIGNDOC_Signature_getFieldPage (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the page number of the signature field. More... | |
int | SIGNDOC_Signature_getSignatureType (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the type of the signature. More... | |
int | SIGNDOC_Signature_getMethod (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the signing method. More... | |
int | SIGNDOC_Signature_getClearedIndex (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the index of the signature at which this signature has been removed. More... | |
int | SIGNDOC_Signature_getDocMDP (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the DocMDP P value of a certification signature. More... | |
int | SIGNDOC_Signature_getLockMDP (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the lock MDP value. More... | |
SIGNDOC_Boolean | SIGNDOC_Signature_getSigningCertificate (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj, struct SIGNDOC_ByteArray *aOutput) |
Get the signing certificate as DER-encoded blob. More... | |
char * | SIGNDOC_Signature_getSignerCommonName (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj, int aEncoding) |
Get the common name from the signing certificate. More... | |
const char * | SIGNDOC_Signature_getSignerCommonNameUTF8 (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the common name from the signing certificate as UTF-8-encoded C string. More... | |
char * | SIGNDOC_Signature_getSignerEmail (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj, int aEncoding) |
Get the email address from the signing certificate. More... | |
const char * | SIGNDOC_Signature_getSignerEmailUTF8 (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the email address from the signing certificate as UTF-8-encoded C string. More... | |
const char * | SIGNDOC_Signature_getTimeStamp (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the time stamp of the signature. More... | |
int | SIGNDOC_Signature_getChangeCount (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the number of changes that have been made after this signature. More... | |
int | SIGNDOC_Signature_getBiometricEncryption (struct SIGNDOC_Exception **aEx, const struct SIGNDOC_Signature *aObj) |
Get the encryption method used for biometric data of the signature field. More... | |
Information about a signature field returned by SIGNDOC_Document_getSignature().
If the SIGNDOC_Document object is destroyed before the SIGNDOC_Signature objects returned by its SIGNDOC_Document_getSignature() function, some functions may fail.
void SIGNDOC_Signature_delete | ( | struct SIGNDOC_Signature * | aObj | ) |
SIGNDOC_Signature destructor.
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
int SIGNDOC_Signature_getBiometricEncryption | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the encryption method used for biometric data of the signature field.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
int SIGNDOC_Signature_getChangeCount | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the number of changes that have been made after this signature.
For PDF documents, you can find out what changes have been made to the document between this signature and the next one (or after the last signature if this is the last signature).
Computing the changes can be expensive.
Changes are not reported in any particular order; before presenting them to a user, you should group them.
Detecting and categorizing changes is work in progress. Moreover, it will never be bug-compatible with Adobe products.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
int SIGNDOC_Signature_getClearedIndex | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the index of the signature at which this signature has been removed.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
int SIGNDOC_Signature_getDocMDP | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the DocMDP P value of a certification signature.
The MDP P value specifies what modifications to the document are allowed by the certification signature.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
char * SIGNDOC_Signature_getFieldName | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj, | ||
int | aEncoding | ||
) |
Get the name of the signature field.
This function throws an exception of type SIGNDOC_EXCEPTION_TYPE_SPOOC_ENCODING_ERROR if the name cannot be represented using the specified encoding.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
[in] | aEncoding | The encoding to be used for the return value (SIGNDOC_ENCODING_NATIVE, SIGNDOC_ENCODING_UTF_8, or SIGNDOC_ENCODING_LATIN_1). |
const char * SIGNDOC_Signature_getFieldNameUTF8 | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the name of the signature field as UTF-8-encoded C string.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
int SIGNDOC_Signature_getFieldPage | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the page number of the signature field.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
int SIGNDOC_Signature_getLockMDP | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the lock MDP value.
The lock MDP value specifies what modifications to the document are allowed by the signature lock dictionary.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
int SIGNDOC_Signature_getMethod | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the signing method.
If the output is SIGNDOC_SIGNATUREPARAMETERS_METHOD_DIGSIG_CADES_RFC3161, the signature is a document time stamp.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
int SIGNDOC_Signature_getSignatureType | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the type of the signature.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
char * SIGNDOC_Signature_getSignerCommonName | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj, | ||
int | aEncoding | ||
) |
Get the common name from the signing certificate.
This function throws an exception of type SIGNDOC_EXCEPTION_TYPE_SPOOC_ENCODING_ERROR if the name cannot be represented using the specified encoding.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
[in] | aEncoding | The encoding to be used for the return value (SIGNDOC_ENCODING_NATIVE, SIGNDOC_ENCODING_UTF_8, or SIGNDOC_ENCODING_LATIN_1). |
const char * SIGNDOC_Signature_getSignerCommonNameUTF8 | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the common name from the signing certificate as UTF-8-encoded C string.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
char * SIGNDOC_Signature_getSignerEmail | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj, | ||
int | aEncoding | ||
) |
Get the email address from the signing certificate.
This function throws an exception of type SIGNDOC_EXCEPTION_TYPE_SPOOC_ENCODING_ERROR if the email address cannot be represented using the specified encoding.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Field object. |
[in] | aEncoding | The encoding to be used for the return value (SIGNDOC_ENCODING_NATIVE, SIGNDOC_ENCODING_UTF_8, or SIGNDOC_ENCODING_LATIN_1). |
const char * SIGNDOC_Signature_getSignerEmailUTF8 | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the email address from the signing certificate as UTF-8-encoded C string.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
SIGNDOC_Boolean SIGNDOC_Signature_getSigningCertificate | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj, | ||
struct SIGNDOC_ByteArray * | aOutput | ||
) |
Get the signing certificate as DER-encoded blob.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |
[in,out] | aOutput | The DER-encoded signing certificate will be stored here. |
const char * SIGNDOC_Signature_getTimeStamp | ( | struct SIGNDOC_Exception ** | aEx, |
const struct SIGNDOC_Signature * | aObj | ||
) |
Get the time stamp of the signature.
You have to use SIGNDOC_Document_verifySignature2() to find out whether the time stamp can be trusted.
[out] | aEx | Any exception will be returned in the object pointed to by this parameter. |
[in] | aObj | A pointer to the SIGNDOC_Signature object. |