Previous Topic: PurposeNext Topic: Return Code


Arguments

The following table gives a brief description of each of the arguments:

Name

I/O

Description

*rp1

Input

A pointer to a parameter control block. Reserved for runtime internal use only.

*rp2

Input

A pointer to a parameter control block. Reserved for runtime internal use only

*pTIRELOG_cmcb

Input/Output

A pointer to a TIRELOG_CMCB structure containing the following items:

lDecryptMaxSize

Input

A long field that contains the maximum available buffer space (in bytes) that the decrypted data can occupy.

lBufferSize

Input/Output

On input, IBufferSize is the current buffer space (in bytes) of the encrypted data.

On output, IBuffferSize should be updated by this exit to contain the length of the decrypted data. The length of the decrypted result cannot exceed lDecryptMaxSize.

*pDataBuffer

Input/Output

On input, a pointer to the starting location of the encrypted View Data and Client Security sections within the CFB work buffer.

On output, this exit should ensure this same data area contains the unencrypted versions of the input data. The length of this decrypted result cannot exceed lDecryptMaxSize.

return_code

Output

A two-character array returning the results of the decryption attempt. The following values are supported:

DECRYPTION_USED—defined as " "

DECRYPTION_SIZE_EXCEEDED_MAX—defined as "01"

DECRYPTION_NOT_USED—defined as "02"

DECRYPTION_APPLICATION_ERROR—defined as "03"

*failureMsg

Output

The pointer to an 80-character array, to be populated by the exit that can receive a null terminated error message string. The string pointed to by the failureMsg pointer will be incorporated into an error message that is returned back to the client. Used in conjunction with a return code of DECRYPTION_APPLICATION_ERROR.