RSA Security logo

RSA BSAFE Cert-C
API Reference

PKCS11_INIT_PARAMS Reference

Passes token initialization information to the Cert-C PKCS #11 Database service provider initialization functions.

When you use C_InitializeCertC() to register the Cert-C PKCS #11 Database service provider, the corresponding handlerParams should point to a PKCS11_INIT_PARAMS structure. Or, if you use C_RegisterService() to register the Cert-C PKCS #11 Database service provider, the corresponding params should point to a PKCS11_INIT_PARAMS structure. You can also use this structure to pass information back to either the application for use in subsequent SPI calls, or to the Crypto-C B_CreateHardwareChooser function.

Data Fields
pPKCS11Info This is both an input and output parameter. As an input parameter, it is a pointer to an initialized B_PKCS11_SESSION structure. This structure contains values for this service provider to establish a session to the token.

As an output parameter, it contains PKCS #11 library, token, and session information used during service-provider initialization. This structure can also be used when initializing the Crypto-C hardware chooser or when initializing the Cert-C Default Cryptographic service provider.

For more information on B_PKCS11_SESSION, see the "B_PKCS11_SESSION Values" section of S_InitializePKCS11DB(), Cert-C Default Cryptographic service provider, and also the Crypto-C Reference Manual.
dbHandle This output parameter is a copy of the service provider's context handle for this database. An application can use this value in later calls to other Cert-C PKCS #11 Database service provider S_*() functions.

#include <pkcs11db.h> 

00079 typedef struct PKCS11_INIT_PARAMS {
00080   B_PKCS11_SESSION  *pPKCS11Info;  /* (mod) address of one session information struct */
00081   POINTER           dbHandle;      /* (out) database context handle                   */
00082 } PKCS11_INIT_PARAMS;
The documentation for this struct was generated from the following file:

RSA BSAFE® Cert-C 2.7 API Reference