	RSA BSAFE Crypto-C	Cryptographic Components for C
		Search

A_SURRENDER_CTX Struct Reference

This structure provides a way to halt a Crypto-C function or to obtain cycles to perform other tasks.

It contains a pointer to an application-specific callback function (Surrender) that Crypto-C uses as its surrender function, and a pointer to application-specific information (handle).

Crypto-C calls the Surrender function at the beginning of any operation that typically takes an extended period of time. The Surrender function surrenders control to the application. The Surrender function also returns an error to Crypto-C in order to cancel an operation.

Before calling any other Crypto-C function, a typical application initializes the A_SURRENDER_CTX value. Each A_SURRENDER_CTX value can specify a different Surrender callback function and a different handle. A surrender context is useful during any time-consuming task, but it is never required.

Samples:: aes.c, aesfb.c, alginfo.c, berder.c, bslec.c, bslite.c, bsliteds.c, descbc.c, dhagree.c, dhagrsv.c, dhparam.c, dintroex.c, dsasign.c, ecdh.c, ecdsa.c, ecdsadig.c, eces.c, ecrand.c, ecspecial.c, ecutil.c, encdec.c, entrpycb.c, feedback.c, genbytes.c, hmac.c, intelrnd.c, introex.c, keywrap.c, mdber.c, mdigest.c, multdecr.c, multencr.c, p11dsakeygen.c, p11dsasign.c, p11rsaencrypt.c, p11rsakeygen.c, p11rsasign.c, parsepkcs5.c, pbe.c, pbkdf2.c, pkcs12pbe.c, pkcs5v2pbe.c, rc2.c, rc2ecb.c, rc4.c, rc4sv.c, rc5.c, rc5ofb.c, rsaoaep.c, rsapkcs.c, rsapkcs2.c, rsapss.c, rsasign.c, rsasign2.c, rsautil.c, scrtshar.c, seed.c, seedfb.c, setoaep.c, sha512.c, tdescfb.c, x931.c, x931rand.c, and x962.c.

#include <aglobal.h>

typedef struct {
  int (RSA_CALLING_CONV *Surrender) PROTO_LIST ((POINTER));
  POINTER handle;
  POINTER reserved;
} A_SURRENDER_CTX;