TElCMSSignature.Validate method

TElCMSSignature.Validate

This method validates the signature.

Declaration

[C#]
    TSBCMSSignatureValidity Validate();
    TSBCMSAdvancedSignatureValidity Validate(short Options);
    TSBCMSAdvancedSignatureValidity Validate(TElX509CertificateValidator Validator, short Options);

[VB.NET]
    Function Validate() As TSBCMSSignatureValidity
    Function Validate(ByVal Options As Short) As TSBCMSAdvancedSignatureValidity
    Function Validate(ByVal Validator As TElX509CertificateValidator, ByVal Options As Short) As TSBCMSAdvancedSignatureValidity

[Pascal]
    function Validate : TSBCMSSignatureValidity;
    function Validate(Options : TSBCMSValidationOptions) : TSBCMSAdvancedSignatureValidity;
    function Validate(Validator : TElX509CertificateValidator; Options : TSBCMSValidationOptions) : TSBCMSAdvancedSignatureValidity;

    TSBCMSValidationOptions = set of TSBCMSValidationOption;

[C++]
    TSBCMSSignatureValidity Validate();
    TSBCMSAdvancedSignatureValidity Validate(TSBCMSValidationOptions Options);
    TSBCMSAdvancedSignatureValidity Validate(TElX509CertificateValidator &Validator, TSBCMSValidationOptions Options);
    TSBCMSAdvancedSignatureValidity Validate(TElX509CertificateValidator *Validator, TSBCMSValidationOptions Options);

[PHP]
    integer Validate()
    integer Validate(integer $Options)
    integer Validate(TElX509CertificateValidator $Validator, integer $Options)

[Java]
    TSBCMSAdvancedSignatureValidity validate(TElX509CertificateValidator Validator, TSBCMSValidationOptions Options);
    TSBCMSSignatureValidity validate();
    TSBCMSAdvancedSignatureValidity validate(TSBCMSValidationOptions Options);

Parameters

Validator - reference to the TElX509CertificateValidator object which will be used for validation
Options - signature validation options

Possible TSBCMSValidationOption values:

[.NET]	[Pascal]	[C++]	Description
cvoRecursiveValidation = 1	cvoRecursiveValidation	f_cvoRecursiveValidation = 1	if this flag is enabled, recursive validation is used.
cvoValidateChains = 2	cvoValidateChains	f_cvoValidateChains = 2	if this flag is enabled, whole certificate chains will be validated.
cvoValidateTimes = 4	cvoValidateTimes	f_cvoValidateTimes = 4	if this flag is enabled, timestamps will be validated.
cvoCheckRevocationStatus = 8	cvoCheckRevocationStatus	f_cvoCheckRevocationStatus = 8	if this flag is enabled, revocation information will be checked.
cvoRequireTimestamps = 16	cvoRequireTimestamps	f_cvoRequireTimestamps = 16	if this option is enabled, timestamps are required for successfull validation.
cvoIgnoreLocalTimestamps = 32	cvoIgnoreLocalTimestamps	f_cvoIgnoreLocalTimestamps = 32	if this option is enabled, local timestampts will be ignored.
cvoValidateTrusts = 64	cvoValidateTrusts	f_cvoValidateTrusts = 64	if this option is enabled, trusts will be validated.

Return value

Returns signature validity status.

Possible TSBCMSSignatureValidity values:

[.NET] [C++]	[Pascal]	Description
csvValid = 0	csvValid	Signature is valid
csvInvalid = 1	csvInvalid	Signature is invalid
csvSignerNotFound = 2	csvSignerNotFound	Signer not found
csvGeneralFailure = 3	csvGeneralFailure	General failure

Possible TSBCMSAdvancedSignatureValidity values:

[.NET] [C++]	[Pascal]	Description
casvValid = 0	casvValid	Signature is valid
casvSignatureCorrupted = 1	casvSignatureCorrupted	Signature is corrupted
casvSignerNotFound = 2	casvSignerNotFound	Signer not found
casvIncompleteChain = 3	casvIncompleteChain	Certificate chain is incomplete
casvBadCountersignature = 4	casvBadCountersignature	Countersignature is invalid
casvBadTimestamp = 5	casvBadTimestamp	Bad timestamp
casvCertificateExpired = 6	casvCertificateExpired	Certificate was expired
casvCertificateRevoked = 7	casvCertificateRevoked	Certificate was revoked
casvCertificateCorrupted = 8	casvCertificateCorrupted	Corrupted certificate
casvUntrustedCA = 9	casvUntrustedCA	Untrusted Certificate Authority
casvRevInfoNotFound = 10	casvRevInfoNotFound	Revocation info was not found
casvTimestampInfoNotFound = 11	casvTimestampInfoNotFound	Timestamp info was not found
casvFailure = 12	casvFailure	General failure
casvCertificateMalformed = 13	casvCertificateMalformed	Certificate malformed
casvUnknown = 14	casvUnknown	Unknown validity
casvChainValidationFailed = 15	casvChainValidationFailed	Chain validation has failed

TSBCMSValidationOptions values

[.NET][C++]	[Pascal]	[PHP]	Description
f_cvoRecursiveValidation = 1	cvoRecursiveValidation	cvoRecursiveValidation = 1	...
f_cvoValidateChains = 2	cvoValidateChains	cvoValidateChains = 2	...
f_cvoValidateTimes = 4	cvoValidateTimes	cvoValidateTimes = 4	...
f_cvoCheckRevocationStatus = 8	cvoCheckRevocationStatus	cvoCheckRevocationStatus = 8	...
f_cvoRequireTimestamps = 16	cvoRequireTimestamps	cvoRequireTimestamps = 16	...
f_cvoIgnoreLocalTimestamps = 32	cvoIgnoreLocalTimestamps	cvoIgnoreLocalTimestamps = 32	...
f_cvoValidateTrusts = 64	cvoValidateTrusts	cvoValidateTrusts = 64	...

Description

Use this method to validate the signature.

Note, if the third overload of this method is used, cvoValidateTrusts and cvoCheckRevocationStatus validation options are ignored. The corresponding trust and revocation validation settings should be adjusted via the properties of TElX509CertificateValidator class.