Vtk_CtxtSetVaInfo
Toolkit Reference

prevnext

Vtk_CtxtSetVaInfo

#include <vtk_ctxt.h>
#include <vtk_err.h>
Vtk_uint32 Vtk_CtxtSetVaInfo(
Vtk_Ctxt* ctxt, /* input */
const Vtk_Cert *caCert, /* input */
const char *vaUrl, /* input */
enum Vtk_ValidationMech mech, /* input */
const Vtk_ProtocolDetails *protDetails,
/* input */
const Vtk_CertStore *vaCerts /* input */
);

Description

This Toolkit context function sets validation information about the VA that is validating certificates issued by a specific CA. The VA validation information includes the VA URL, validation mechanism and optionally, the list of trusted VA certificates to be used with this VA or CA.

The VA URL and validation mechanism specified in this function will be used as the default for all validations performed for certificates issued by this CA. If you specify CRL as the validation mechanism, you must also set details about the protocol in the Vtk_ProtocolDetails structure.

You are not required to set the list of trusted certificates using this function. However, if you do not, the VA certificates set through the Vtk_CtxtAddCert and Vtk_CtxtAddCerts calls are used.

Parameters

ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated. The Toolkit context for which this function sets VA information.
caCert CA for which this validation information should be set.
vaUrl URL for default VA, for example http://ocsp.valicert.net:80.
mech Validation mechanism employed to validate certificates. The possible values are:
  • VTK_VM_CRT--Certificate Revocation Tree

  • VTK_VM_OCSP--Online Certificate Status Protocol

  • VTK_VM_CRL--Certificate Revocation List

protDetails Any additional CRL protocol-specific information.
vaCerts List of trusted VA certificates. This is optional. If not specified, the list of trusted VA certificates set through the Vtk_CtxtAddCert and Vtk_CtxtAddCerts is used.

Return Value

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

Notes

None

See Also

Vtk_CRLProtocolDetails

Vtk_ProtocolDetails

Vtk_CtxtAddCert

Vtk_CtxtAddCerts

prevnext


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