Vtk_ValidationAddCertRaw
Toolkit Reference

prevnext

Vtk_ValidationAddCertRaw

#include <vtk_valid.h>
#include <vtk_err.h>
Vtk_uint32 Vtk_ValidationAddCertRaw(
const Vtk_Ctxt *ctxt, /* input */
Vtk_Validation *val, /* input/output */
const Vtk_Buffer *cert, /* input */
const Vtk_Buffer *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. The certificate that is to be added is created from the user supplied data contained in the buffer. To add the certificate to the validation query, the application must specify the end-user certificate and its issuer certificate. The certificates can be specified in raw DER/BASE64 format. If the application wants to later set protocol specific extensions for the this certificate validation query or obtain validation status for this certificate, the application must also 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 specifies 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.

If the application does not use the optional Vtk_ValHdl structure, that is, it passes NULL as the parameter when adding the certificate, the application can use the Vtk_ValidationGetValHdl function to create the validation handle after the certificate is added.



See Also

Vtk_ValHdlGetRevStatus

Vtk_ValidationAddCert

Vtk_ValidationGetRevStatus

Vtk_ValidationGetValHdl

Vtk_ValidationValidate

prevnext


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