Vtk_ValidationGetQueries
Toolkit Reference

prevnext

Vtk_ValidationGetQueries

#include <vtk_valid.h>
#include <vtk_err.h>
Vtk_uint32 Vtk_ValidationGetQueries(
const Vtk_Ctxt *ctxt, /* input */
const Vtk_Validation *val, /* input */
int *valQueryCount, /* input */
Vtk_ValQuery ***queriesOut /* input/output */
);



Description

This validation query function obtains an array of validation query messages contained in the Vtk_Validation data structure. After obtaining the query messages, the application instead of the Toolkit is responsible for communication with each VA returned in the queries.

The application sets the response it obtains from the VA in the response field of the Vtk_ValQuery structure. To complete the validation of these queries the application calls the Vtk_ValidationValidateFromQueries function to check the information in the responses. It must then release the memory occupied by the response buffers.

An application might want to handle the communication with the VA and complete validation with the Vtk_ValidationFromQueries for any of the following reasons:

Parameters

ctxt Pointer to Toolkit context created using the Vtk_CtxtNew function and for which memory has been allocated.
val Pointer to the data structure that encapsulates a set of validation queries that can be sent to one or more VAs.
valQueryCount Number of query messages that are in the Vtk_ValQuery array.
queriesOut Pointer to the array of validation queries that the application sends to the VA for validation.

Return Value

VTK_OK The function has completed successfully and the validation queries have been added to the array.
error code The function has failed. For information about possible error values, refer to Appendix 

Notes

The application must delete the returned array using the Vtk_ValQueriesDelete function. The application is also responsible for releasing the memory allocated to Vtk_Buffer in the response, which is not released by the Vtk_ValQueriesDelete function.



See Also

Vtk_Validation

Vtk_ValQuery

Vtk_ValidationValidateFromQueries

Vtk_ValQueriesDelete

prevnext


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