Vtk_ValidationAddCert
Toolkit Reference

prevnext

Vtk_ValidationAddCert

#include <vtk_valid.h>
#include <vtk_err.h>
Vtk_uint32 Vtk_ValidationAddCert(
const Vtk_Ctxt *ctxt, /* input */
Vtk_Validation *val, /* input/output */
const Vtk_Cert *cert, /* input */
const Vtk_Cert *issuerCert, /* input */
Vtk_ValHdl **hdl /* output */
);

Description

This validation function adds a single certificate to the validation query (Vtk_Validation structure created using the Vtk_ValidationNew function) that will be sent to the VA or Global VA Service for validation. To add the certificate to the validation query, the application must specify the end-user certificate and its issuer certificate. If the application wants to later set protocol specific extensions for this certificate validation or obtain validation status for this certificate, the application can use the optional Vtk_ValHdl structure.

Parameters

ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
val Pointer to the validation query structure to which the certificate is to be added.
cert Pointer to the certificate to add to the validation query structure for validation.
issuerCert Pointer to issuer certificate for the certificate to be validated.
hdl Pointer to a auxiliary data structure used to link individual certificate validation requests to their detail.This is an optional return value.

Return Value

VTK_OK The function has completed successfully and the certificate has been added to the validation query.
error code The function has failed. For information about possible error values, refer to Appendix 

Notes

If the application allocates memory to the Vtk_ValHdl structure, it can set extensions, obtain validation status, and obtain details specific to a certificate instead of as an aggregate value of all the certificates. However, since memory is allocated to this auxiliary structure, the application must call the Vtk_ValHdlDelete function to release it when the structure is no longer needed.

Alternatively, the application can use the Vtk_ValidationGetValHdl function to create the validation handle after the certificate is added.



See Also

Vtk_ValHdlGetRevStatus

Vtk_ValidationAddCertRaw

Vtk_ValidationGetRevStatus

Vtk_ValidationGetValHdl

Vtk_ValidationGetValHdl

Vtk_ValidationValidate

prevnext


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