Vtk_ValidationValidate
Toolkit Reference

prevnext

Vtk_ValidationValidate

#include <vtk_valid.h>
#include <vtk_err.h>
Vtk_uint32 Vtk_ValidationValidate(
const Vtk_Ctxt *ctxt, /* input */
Vtk_Validation *val, /* input */
Vtk_uint32 *valStatus /* output */
);

Description

This validation function sends the validation request(s) to the VA to perform the validation. Calling this function can result in one or more validation queries being sent to one or several VAs.

Parameters

ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
val Validation query structure that contains certificates to be validated.
valStatus Aggregate validation status of all the certificates in the validation query structure. The function must return VTK_OK for the status field to be valid. All the certificates must pass validation for the validation status to be VTK_STATUS_OK.

Return Value

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

Notes

Since the validation status is an aggregate value, one revoked certificate causes the value of the returned status to be revoked.
The application can obtain validation status for an individual certificate by including a Vtk_ValHdl auxiliary data structure when the certificate is added to the list of certificates to be validated. A certificate is added using the Vtk_ValidationAddCert and Vtk_ValidationAddCertRaw functions. Retrieving the validation status for the individual certificate can be done using the Vtk_ValHdlGetRevStatus or Vtk_ValidationGetRevStatus function.



See Also

Vtk_ValHdlGetRevStatus

Vtk_ValidationAddCert

Vtk_ValidationAddCertRaw

Vtk_ValidationGetValHdl

prevnext


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