This certificate store function initializes a Vtk_CertStore data structure using the data in the file that the application passes to it.
Parameters
ctxt
Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
dest
Pointer to the newly initialized Vtk_CertStore structure.
filename
File that contains the certificate data. The file can contain one or more certificates.
format
Encoding and decoding method employed. The possible values for this enumeration are:
VTK_DF_DER
VTK_DF_BASE64
Return Value
VTK_OK
The function has completed successfully and the certificate store structure has been initialized from the named file.
error code
The function has failed. For information about possible error values, refer to
Appendix
Notes
Encoding information is passed in the Vtk_DataFormat enumeration. Compare this to the VtkCertStoreAddCert function which uses the Vtk_Cert structure to pass certificate information and the Vtk_CertStoreAddRaw function which uses the Vtk_Buffer structure to pass encoding and certificate information.