PKCSError class

From m204wiki
Jump to: navigation, search

The PKCSError exception class describes an exception associated with finding data that does not conform to the Public-Key Cryptography Standards (PKCS). See, for example, PKCS #1 for more information about what the standards affect.

To produce a PKCSError exception yourself, you typically use a SOUL Throw statement with a PKCSError New constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws a PKCSError exception:

throw %(PKCSError):new

For an outline of how you might use an exception in a function of your own, see this Get method example.

The PKCSErrormethods

The following are the available PKCSError class methods.

MethodDescription
Code
Description
NewCreate a new PKCSError object

The methods in the class are described in the subsections that follow. In addition:

Code function

Code method (PKCSError class)

Syntax

%number = pKCSError:Code

Syntax terms

%number This numeric variable is one of the return codes that can be reported by the AppendCertificateRequest or AppendSignedCertificate methods.
pkcsError An instance of a PKCSError object.

Description function

Description method (PKCSError class)

Syntax

%string = pKCSError:Description

Syntax terms

%string A string to contain the description of the exception.
pkcsError An instance of a PKCSError object.

New constructor

Create a new PKCSError object (PKCSError class)

This Constructor generates an instance of a PKCSError exception. As shown below, the New method takes no arguments.

Syntax

%pKCSError = [%(PKCSError):]New( Code= number, Description= string)

Syntax terms

%pkcsError A reference to an instance of a PKCSError object.
[%(PKCSError):]The class name in parentheses denotes a Constructor.