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.