This certificate store function adds a single certificate to the Vtk_CertStore structure which was created using the Vtk_CertStoreNew function.
Parameters
ctxt
Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
dest
Pointer to certificate store to which this certificate is to be added. A certificate store is a container for one or more certificates.
aCert
Pointer to the certificate that is to be added to the store. This certificate is contained in an initialized structure.
Return Value
VTK_OK
The function has completed successfully and the certificate has been added to the certificate store.
error code
The function has failed. For information about possible error values, refer to
Appendix
Notes
Vtk_Cert structure is used to encapsulate the X.509 certificates. Compare this to the VtkCertStoreAddRaw function which uses the Vtk_Buffer structure to pass encoding and certificate information. To add several certificates, the application can call this function several times or more conveniently, the Vtk_CertStoreLoadFromFile to add several certificates at one time. A certificate store can contain certificates that use different encoding formats. There is no practical limit on the number of certificates that a certificate store can contain. The application is responsible for releasing the memory allocated to the certificate it has passed in to the function.