Vtk_ValidationGetRevStatus
Toolkit Reference

prevnext

Vtk_ValidationGetRevStatus

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

Description

This validation function retrieves validation status information for a single certificate. The application can request detailed revocation information for the entire validation response or a single certificate. For information about the detailed information, see Vtk_ValRespDetails or Vtk_ValRespSingleCertDetails.

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 your application.
cert Pointer to the certificate for which status information is being requested.
issuerCert Pointer to the issuer certificate.
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

This function is similar to the Vtk_ValHdlGetRevStatus function which allows the application to return this type of information directly for a certificate added to the validation query with a validation handle.
If the application requests detailed revocation information (either respDetails or certDetails) but this information is not available in the response, the function returns VTK_OK, but the return values in the structure are not set.



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