Upgrade Method
Upgrades existing CAdES or XAdES signature to a new level.
Syntax
int Upgrade(int iToLevel);
Remarks
CAdES and XAdES standard defines a number of different 'levels' or 'forms' of signatures which can be used for different purposes. Use this method to upgrade CAdES or XAdES signature to a new level specified by ToLevel. Signatures can normally be upgraded from less sophisticated levels (BES, EPES) to more sophisticated (T, XL, A).
Supported levels:
| aslUnknown | 0 |
| aslBES | 1 |
| aslEPES | 2 |
| aslT | 3 |
| aslC | 4 |
| aslXType1 | 5 |
| aslXType2 | 6 |
| aslXLType1 | 7 |
| aslXLType2 | 8 |
| aslBaselineB | 9 |
| aslBaselineT | 10 |
| aslBaselineLT | 11 |
| aslBaselineLTA | 12 |
| aslExtendedBES | 13 |
| aslExtendedEPES | 14 |
| aslExtendedT | 15 |
| aslExtendedC | 16 |
| aslExtendedXType1 | 17 |
| aslExtendedXType2 | 18 |
| aslExtendedXLType1 | 19 |
| aslExtendedXLType2 | 20 |
| aslA | 21 |
| aslExtendedA | 22 |
Error Handling
This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)