All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
pdftron::PDF::VerificationResult Class Reference

#include <VerificationResult.h>

Public Types

enum  DocumentStatus {
  e_no_error = 0, e_corrupt_file = 1, e_unsigned = 2, e_bad_byteranges = 3,
  e_corrupt_cryptographic_contents = 4
}
 
enum  DigestStatus {
  e_digest_invalid = 0, e_digest_verified = 1, e_digest_verification_disabled = 2, e_weak_digest_algorithm_but_digest_verifiable = 3,
  e_no_digest_status = 4, e_unsupported_encoding = 5, e_unsupported_digest_algorithm = 6
}
 
enum  TrustStatus {
  e_trust_verified = 0, e_untrusted = 1, e_trust_verification_disabled = 2, e_no_trust_status = 3,
  e_unsupported_trust_features = 4
}
 
enum  ModificationPermissionsStatus {
  e_invalidated_by_disallowed_changes = 0, e_has_allowed_changes = 1, e_unmodified = 2, e_permissions_verification_disabled = 3,
  e_no_permissions_status = 4, e_unsupported_permissions_features = 5
}
 
typedef
pdftron::PDF::DisallowedChange 
DisallowedChange
 

Public Member Functions

 VerificationResult (const VerificationResult &other)
 
VerificationResultoperator= (const VerificationResult &other)
 
 ~VerificationResult ()
 
void Destroy ()
 
bool GetVerificationStatus () const
 
DocumentStatus GetDocumentStatus () const
 
DigestStatus GetDigestStatus () const
 
TrustStatus GetTrustStatus () const
 
ModificationPermissionsStatus GetPermissionsStatus () const
 
bool HasTrustVerificationResult () const
 
TrustVerificationResult GetTrustVerificationResult () const
 
std::vector< DisallowedChangeGetDisallowedChanges () const
 
Crypto::DigestAlgorithm::Type GetDigestAlgorithm () const
 
UString GetDocumentStatusAsString () const
 
UString GetDigestStatusAsString () const
 
UString GetTrustStatusAsString () const
 
UString GetPermissionsStatusAsString () const
 
std::vector< UStringGetUnsupportedFeatures () const
 
 VerificationResult (TRN_VerificationResult impl)
 

Public Attributes

TRN_VerificationResult m_impl
 

Detailed Description

The result of a verification operation performed on a digital signature.

Definition at line 25 of file VerificationResult.h.

Member Typedef Documentation

Member Enumeration Documentation

Enumerator
e_digest_invalid 
e_digest_verified 
e_digest_verification_disabled 
e_weak_digest_algorithm_but_digest_verifiable 
e_no_digest_status 
e_unsupported_encoding 
e_unsupported_digest_algorithm 

Definition at line 37 of file VerificationResult.h.

Enumerator
e_no_error 
e_corrupt_file 
e_unsigned 
e_bad_byteranges 
e_corrupt_cryptographic_contents 

Definition at line 30 of file VerificationResult.h.

Enumerator
e_invalidated_by_disallowed_changes 
e_has_allowed_changes 
e_unmodified 
e_permissions_verification_disabled 
e_no_permissions_status 
e_unsupported_permissions_features 

Definition at line 53 of file VerificationResult.h.

Enumerator
e_trust_verified 
e_untrusted 
e_trust_verification_disabled 
e_no_trust_status 
e_unsupported_trust_features 

Definition at line 46 of file VerificationResult.h.

Constructor & Destructor Documentation

pdftron::PDF::VerificationResult::VerificationResult ( const VerificationResult other)
pdftron::PDF::VerificationResult::~VerificationResult ( )
pdftron::PDF::VerificationResult::VerificationResult ( TRN_VerificationResult  impl)

Member Function Documentation

void pdftron::PDF::VerificationResult::Destroy ( )
Crypto::DigestAlgorithm::Type pdftron::PDF::VerificationResult::GetDigestAlgorithm ( ) const

Retrieves an enumeration value representing the digest algorithm used to sign the signature that is associated with this verification result. For DocTimeStamp signatures, returns the weakest algorithm found (between the CMS and message imprint digests).

Returns
A DigestAlgorithm enumeration value.
DigestStatus pdftron::PDF::VerificationResult::GetDigestStatus ( ) const

Retrieves the digest-related result condition associated with a digital signature verification operation.

Returns
A DigestStatus-type enumeration value.
UString pdftron::PDF::VerificationResult::GetDigestStatusAsString ( ) const

Retrieves the digest-related result condition associated with a digital signature verification operation, as a descriptive string.

Returns
a string.
std::vector<DisallowedChange> pdftron::PDF::VerificationResult::GetDisallowedChanges ( ) const

Retrieves a list of informational structures regarding any disallowed changes that have been made to the document since the signature associated with this verification result was signed.

Returns
a collection of DisallowedChange objects.
DocumentStatus pdftron::PDF::VerificationResult::GetDocumentStatus ( ) const

Retrieves the document-related result condition associated with a digital signature verification operation.

Returns
A DocumentStatus-type enumeration value.
UString pdftron::PDF::VerificationResult::GetDocumentStatusAsString ( ) const

Retrieves the document-related result condition associated with a digital signature verification operation, as a descriptive string.

Returns
a string.
ModificationPermissionsStatus pdftron::PDF::VerificationResult::GetPermissionsStatus ( ) const

Retrieves the result condition about permissions checks performed on any unsigned modifications associated with a digital signature verification operation.

Returns
A ModificationPermissionsStatus-type enumeration value.
UString pdftron::PDF::VerificationResult::GetPermissionsStatusAsString ( ) const

Retrieves the result condition about permissions checks performed on any unsigned modifications associated with a digital signature verification operation, as a descriptive string.

Returns
a string.
TrustStatus pdftron::PDF::VerificationResult::GetTrustStatus ( ) const

Retrieves the trust-related result condition associated with a digital signature verification operation.

Returns
A TrustStatus-type enumeration value.
UString pdftron::PDF::VerificationResult::GetTrustStatusAsString ( ) const

Retrieves the trust-related result condition associated with a digital signature verification operation, as a descriptive string.

Returns
a string.
TrustVerificationResult pdftron::PDF::VerificationResult::GetTrustVerificationResult ( ) const

Retrieves the detailed result associated with the trust step of the verification operation that returned this VerificationResult, if such a detailed trust result is available. Must call HasTrustVerificationResult first and check for a true result.

Returns
a TrustVerificationResult object
Note
This function will throw if no TrustVerificationResult is available.
std::vector<UString> pdftron::PDF::VerificationResult::GetUnsupportedFeatures ( ) const

Retrieves reports about unsupported features encountered during verification. This function is the canonical source of information about all unsupported features encountered. Current possible values: "unsupported signature encoding", "usage rights signature", "legal content attestations", "unsupported digest algorithm"

Returns
a container of strings representing unsupported features encountered during verification
Note
Output may change in future versions.
bool pdftron::PDF::VerificationResult::GetVerificationStatus ( ) const

Retrieves the main verification status. The main status is determined based on the other statuses. Verification may fail for many reasons; some of these reasons are the presence of features that are not supported yet. It may be desirable for you to report unsupported signatures differently (for example, using a question mark rather than an X mark). Any unsupported features encountered can be retrieved by the use of the function GetUnsupportedFeatures on this class.

Returns
A boolean representing whether or not the verification operation was completely successful.
bool pdftron::PDF::VerificationResult::HasTrustVerificationResult ( ) const

Returns whether there is a detailed TrustVerificationResult in this VerificationResult or not.

Returns
A boolean.
VerificationResult& pdftron::PDF::VerificationResult::operator= ( const VerificationResult other)

Member Data Documentation

TRN_VerificationResult pdftron::PDF::VerificationResult::m_impl

Definition at line 192 of file VerificationResult.h.


The documentation for this class was generated from the following file: