Vtk_ValidationGetValHdl
Toolkit Reference

prevnext

Vtk_ValidationGetValHdl

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

Description

This validation function creates a validation handle for a specific certificate within a validation query. This function is useful if the application added certificates to the query using the Vtk_ValidationAddCertChain function or did not specify the Vtk_ValHdl when it added the certificate using the Vtk_ValidationAddCert or Vtk_ValidationAddCertRaw function.

Once the application obtains the Vtk_ValHdl, it can use it to obtain detailed revocation information or specify certificate extensions in the validation request.

Parameters

ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
val Pointer to the validation data structure that encapsulates a set of validation queries that can be sent to one or more VAs. The validation query structure is opaque to the your application.
cert Pointer to the certificate for which a validation handle is being requested.
issuerCert Pointer to the issuer certificate.
hdl Pointer to a auxiliary data structure used to link individual certificate validation requests to their detail.

Return Value

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

Notes

The application can use the Vtk_ValidationGetValHdl function to create a validation handle after the certificate is added. The application added through the Vtk_ValidationAddCertChain function.

If the application creates a 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.



See Also

Vtk_ValHdlDelete

Vtk_ValidationAddCert

Vtk_ValidationAddCertRaw

Vtk_ValidationAddCertChain

Vtk_ValidationAddReqExtForSingleCertHdl

prevnext


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