Vtk_CRLValidateCert
Toolkit Reference

prevnext

Vtk_CRLValidateCert

#include <vtk_valid.h>
#include <vtk_err.h>
Vtk_uint32 Vtk_CRLValidateCert(
const Vtk_Ctxt *ctxt, /* input */
const Vtk_Cert *cert, /* input */
Vtk_uint32 *status, /* output */
Vtk_ValRespDetails **respDetails,
/* input/output */
Vtk_ValRespSingleCertDetails *certDetails
/* input/output */
);

Description

This validation function checks whether the specified certificate is on the CRL and returns a status information about the certificate. The application can optionally specify to return detailed revocation information for the entire validation response or the single certificate.

Parameters
ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
cert Pointer to the certificate to check for in the CRL.
status Pointer to the status information for the certificate. The status values are defined as a bit field. Therefore, a single status value can represent multiple status codes. For a list of the possible certificate status codes, see Appendix 
respDetails Address to the pointer to the detailed revocation information for the entire response. (It points to a structure allocated by the Toolkit in this call.) This function returns the requested information in the structure. In cases where the result is not needed, the application can pass in NULL. The application must release this structure using the Vtk_ValRespDetailsDelete function.
certDetails Address to the pointer to the detailed revocation information for a single certificate response. (It points to a structure allocated by the Toolkit in this call.) This function returns the requested information in the structure. In cases where the result is not needed, the application can pass in NULL. The application must release this structure using the Vtk_ValRespSingleCertDetailsDelete function.

Return Value

VTK_OK The function has completed successfully and if specified, returns the Vtk_ValRespDetails or Vtk_ValRespSingleCertDetail structure.
error code The function has failed. For information about possible error values, refer to Appendix 

Notes

The function uses the configuration data in the context to obtain the CRL.
Unlike most validation functions, this function does not require the Vtk_Validation structure.
If the application specifies Vtk_RespDetails or Vtk_ValRespSingleCertDetails, but the VA does not have any information for the specified certificate, the function returns successfully (VTK_OK) and sets the specified structure to NULL.
The application must release these structures using the Vtk_ValRespDetailsDelete or Vtk_ValRespSingleCertDetailsDelete function.


See Also

Vtk_ValRespDetails

Vtk_ValRespSingleCertDetails

Vtk_ValRespDetailsDelete

Vtk_ValRespSingleCertDetailsDelete

prevnext


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