XYGATE
®
Data Protection
™
Reference Manual
Appendix E: XDP API Procedures
XYPRO Technology Corporation
132
Proprietary and Confidential
sencr_method
The name of the encryption method to be used for encryption. These values are defined in the DPCONF
file in the ENCRMETHOD lines; the encryption method name is the third word of those lines.
For example:
ENCRMETHOD VOLTAGE FPE FPEMETH
nencr_method_len
The length of encryption method name contained in
sencr_method
.
sprovider_name
The provider name associated with this encryption method. The provider name is found in the DPCONF
file in the ENCRMETHOD lines; the provider name is the second word of those lines.
For example:
ENCRMETHOD VOLTAGE FPE FPEMETH
nprovider_name_len
The length of the provider name contained in
sprovider_name
.
nserv_index
An output parameter that is returned from the procedure
__XYPRO_ADD_ENCR_METHOD ()
to indicate which
encryption provider to invoke. The returned value is important only when there is more than one
encryption provider defined; since there currently is only one encryption provider defined, you can simply
pass any value returned in this field to
__XYPRO_ENCR_SEND_TO_ENCR_SRV ()
.
binitial_call
A Boolean value. This should be non-zero the first time the procedure is called and then 0 for all
subsequent invocations.
Example:
/* Global Storage */
encr_init_struct *encr_init = NULL; /* Encryption initialization structure */
short nserv_index1; /* Pathway server index 1 */
short nserv_index2; /* Pathway server index 1 */
...
/* Local Storage */
short nerror;
bool first_call;
...
char sencr_method[6] = { "TOKEN" } /* TOKEN encrypt method */
,spathmon_name[5] = { "$MPW" } /* Pathmon process name */
,sserverclass_name[8] = { "VOLTSRV" } /* Encryption server class */
,sprovider_name [8] = { "VOLTAGE" }; /* VOLTAGE is the provider */
;
encr_init_struct *encr_init;
encr_init = malloc (sizeof(encr_init_struct));
...
first_call = TRUE;
