Vtk_CertStoreNew
Toolkit Reference

prevnext

Vtk_CertStoreNew

#include <vtk_cert.h>
#include <vtk_err.h>
Vtk_CertStore* Vtk_CertStoreNew(
const Vtk_Ctxt *ctxt /* input */
);

Description

This certificate store function creates and initializes an empty Vtk_CertStore structure which can be used to group and store VA or CA certificates. During the creation phase, this function allocates memory and resources for the structure. The certificate store is used during query validation and chain building operations.

Parameters
ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.

Return Value

Vtk_CertStore The function has completed successfully. The function returns the Vtk_CertStore structure that has been newly created and initialized.
NULL The function has failed.

Notes

Once the certificate store structure is created, the application can add certificates individually (Vtk_CertStoreAddCert), as raw encoded data (Vtk_CertStoreAddRaw), or several at a time from a file (Vtk_CertStoreLoadFromFile).
The application must call the Vtk_CertStoreDelete function for each certificate store created using Vtk_CertStoreNew. If the application does not call Vtk_CertStoreDelete, memory leaks and other problems can occur. For more information about the Toolkit memory model, see Toolkit Memory Model.


See Also

Vtk_CertStoreDelete

prevnext


ValiCert, Inc.
http://www.valicert.com
Voice: +1.650.567.5469
Fax: (+1.650.254.2148
support@valicert.com