RSA Security logo

RSA BSAFE Cert-C
API Reference

MS_CAPI_DB_PARAMS Struct Reference

Use the MS_CAPI_DB_PARAMS structure to pass initialization parameters to the Cert-C CryptoAPI Database service provider's initialization functions.

When you register the Cert-C CryptoAPI Database service provider, the corresponding handlerParams should point to an MS_CAPI_DB_PARAMS structure. Or, if you use C_RegisterService() to register the Cert-C CryptoAPI Database service provider, the corresponding params should point to an MS_CAPI_DB_PARAMS structure.

Data Fields
pCryptoProviderName A NUL- terminated string specifying the name of the cryptographic service provider (CSP) to be used; the default is Security Dynamics Desktop Provider. Only one cryptographic service provider name is allowed. The cryptographic service provider name can be one of the following:
  • "RSA Security Desktop Provider" (for RSA Keon Desktop v 5.5 and v 5.6)
  • "Security Dynamics Desktop Provider" (for RSA Keon Desktop v 5.1)
  • "Microsoft Enhanced Cryptographic Provider v1.0"
  • "Microsoft Base Cryptographic Provider v1.0"
  • "Microsoft Exchange Cryptographic Provider v1.0"
  • "Microsoft Base DSS Cryptographic Provider"
  • "Microsoft Base DSS and Diffie-Hellman Cryptographic Provider"
  • "Intel Hardware Cryptographic Service Provider" for Win95 and Win98
Not all of these CSPs are available on all machines, and there can be more CSPs, depending on what applications have been installed.
pKeyContainerName A NUL-terminated string specifying the key container name to be used. If pKeyContainerName is passed a string containing NUL, then the default is dependent on the CSP used.
pCertSystemStoreName The certificate store name to be opened; if it is NULL the default is MY. The certificate store name can be one of the following:
  • MY
  • CA
  • ROOT
  • SPC
  • Trust
  • AddressBook
dwProviderType The type of cryptographic service provider to be used; the default is PROV_RSA_FULL.
dwKeySpec The key spec to be used in private-key operations; the default is AT_SIGNATURE. The key spec can be one of the following:
  • AT_SIGNATURE
  • AT_KEYEXCHANGE

#include <capiprov.h> 

00154 typedef struct
00155 {
00156     LPCTSTR pCryptoProviderName ;   /* One crypto provider name only */
00157     LPCTSTR pKeyContainerName ;     /* Key container name to be used */
00158     LPCTSTR pCertSystemStoreName ;  /* Default to "MY" */
00159     DWORD   dwProviderType ;        /* Default to PROV_RSA_FULL */
00160     DWORD   dwKeySpec ;             /* AT_SIGNATURE or AT_KEYEXCHANGE,
00161                                        This is used for InsertPrivateKey() */
00162 } MS_CAPI_DB_PARAMS ;
The documentation for this struct was generated from the following file:

RSA BSAFE® Cert-C 2.7 API Reference