Signature Components API

Signature Components API
3.1.2 Methods
3.1.2.1 CheckIntegrity
Checks the integrity of the Signature object to detect whether it has been tampered with since
signing.
IntegrityStatus CheckIntegrity( Key )
Parameters:
Key
Optional Key object. If not supplied the code uses Key type MD5 by
default.
Return Value: IntegrityStatus
IntegrityOK
Data has not changed since signature capture
IntegrityFail
Data has changed since signature capture
IntegrityMissing
Signature integrity value not found
IntegrityWrongType Signature was captured using a different integrity check version
3.1.2.2 CheckSignedData
Checks for a match between a given hash and that provided when the signature was captured. If the
signature is bound to a hash (ie. the What argument of the DynamicCapture or SigCtl Capture
method was set), then this function checks the signed data against that from which the supplied
hash was derived.
This method is called by SigCtlXHTML.CheckHostDocument() which supplies the necessary Hash.
SignedData CheckSignedData(Hash)
Parameters:
Hash
Return Value: SignedData
DataGood
DataNoHash
DataBadType
DataBadHash
Hash object, to be compared with that provided when the signature
was captured.
The supplied hash matches that provided when the signature was
captured, thus both Hash objects have been derived from the same
data set.
No hash was specified when the signature was captured (or the
object does not contain a signature).
The supplied hash is of a different type (HashType Enum) to that
provided when the signature was captured.
The supplied hash value does not match that provided when the
signature was captured, thus the two Hash objects have been
derived from different data sets.
3.1.2.3 Clear
Clears all signature data and thus reinitializes the Signature object.
Void Clear()
Parameters: none
Return Value: none
Page 8 of 75