#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) | |
VerificationResult & | operator= (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< DisallowedChange > | GetDisallowedChanges () const |
Crypto::DigestAlgorithm::Type | GetDigestAlgorithm () const |
UString | GetDocumentStatusAsString () const |
UString | GetDigestStatusAsString () const |
UString | GetTrustStatusAsString () const |
UString | GetPermissionsStatusAsString () const |
std::vector< UString > | GetUnsupportedFeatures () const |
VerificationResult (TRN_VerificationResult impl) | |
Public Attributes | |
TRN_VerificationResult | m_impl |
The result of a verification operation performed on a digital signature.
Definition at line 25 of file VerificationResult.h.
Definition at line 28 of file VerificationResult.h.
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.
pdftron::PDF::VerificationResult::VerificationResult | ( | const VerificationResult & | other | ) |
pdftron::PDF::VerificationResult::~VerificationResult | ( | ) |
pdftron::PDF::VerificationResult::VerificationResult | ( | TRN_VerificationResult | impl | ) |
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).
DigestStatus pdftron::PDF::VerificationResult::GetDigestStatus | ( | ) | const |
Retrieves the digest-related result condition associated with a digital signature verification operation.
UString pdftron::PDF::VerificationResult::GetDigestStatusAsString | ( | ) | const |
Retrieves the digest-related result condition associated with a digital signature verification operation, as a descriptive 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.
DocumentStatus pdftron::PDF::VerificationResult::GetDocumentStatus | ( | ) | const |
Retrieves the document-related result condition associated with a digital signature verification operation.
UString pdftron::PDF::VerificationResult::GetDocumentStatusAsString | ( | ) | const |
Retrieves the document-related result condition associated with a digital signature verification operation, as a descriptive 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.
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.
TrustStatus pdftron::PDF::VerificationResult::GetTrustStatus | ( | ) | const |
Retrieves the trust-related result condition associated with a digital signature verification operation.
UString pdftron::PDF::VerificationResult::GetTrustStatusAsString | ( | ) | const |
Retrieves the trust-related result condition associated with a digital signature verification operation, as a descriptive 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.
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"
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.
bool pdftron::PDF::VerificationResult::HasTrustVerificationResult | ( | ) | const |
Returns whether there is a detailed TrustVerificationResult in this VerificationResult or not.
VerificationResult& pdftron::PDF::VerificationResult::operator= | ( | const VerificationResult & | other | ) |
TRN_VerificationResult pdftron::PDF::VerificationResult::m_impl |
Definition at line 192 of file VerificationResult.h.