CMDBQueryStruct structure

The CMDBQueryStruct structure holds a list of query objects with qualification for the instances to retrieve. This is a top-level structure, which is used in the CMDBQueryByPath function.


typedef struct CMDBQueryStruct
{
   ARNameType datasetId;
   unsigned int datasetMask;
   CMDBQueryObjectList *queryObjects;
   CMDBQueryObjectOptionalList *queryObjectsOptional;
   CMDBQueryObjectSelectorList *queryObjectsToSelect;
   unsigned int firstRetrieve;
   unsigned int maxRetrieve;
   CMDB_QUERY_STRUCT_MASK_TYPE queryMask;
   CMDBQuerySortList querySortList;
   ARBoolean numMatches;
} CMDBQueryStruct;

The CMDBQueryStruct structure consists of the following elements:

datasetId	The ID of the dataset from which to retrieve the instances.
datasetMask	An integer value that specifies the dataset type for the query. 0 -- Based on the `datasetId` passed, instances are retrieved from either the overlay or the original dataset (`CMDB_GET_MASK_NONE` ). 1 << 0 --Allows you to retreive instances from the current dataset only .(`CMDB_GET_DATASET_MODE_CURRENT` ).
queryObjects	A pointer to `CMDBQueryObjectList`, which contains a list of `CMDBQueryObject` structures that specify the qualifications for the instance to retrieve.
queryObjectsOptional	A pointer to the `CMDBQueryObjectList` structure, which specifies the optional qualifications for the query. For example, when querying for all computer systems in an organization, you might also want to retrieve the printers to which these computer systems are connected. A computer system might not be connected to a printer, in which case returning a printer becomes optional.
queryObjectsToSelect	A pointer to `CMDBQueryObjectSelectorList`, which contain the class name and attributes to select from each instance in the result that met the required condition.
firstRetrieve	The first object to retrieve from the list of objects returned.
maxRetrieve	The maximum number of objects to retrieve from the list of objects returned.
queryMask	An integer value that specifies the properties for returning the query results. 0 --The query results are returned in a list or linear format (`CMDB_QUERY_RESULT_STRUCT_FORMAT_LIST` ). 1 --The query results are divided in two parts: a list of CIs nodes and a list of relationship edges, which helps in constructing a CI and relationship graph (`CMDB_QUERY_RESULT_STRUCT_FORMAT_CMDB_GRAPH` ). 2 --The query results are returned in a graph format if the number of rows that matches the criteria is within the chunk size. The results are returned in a list format if the number of rows that matches is greater than the chunk size (`CMDB_QUERY_RESULT_STRUCT_FORMAT_CHUNK_BASED` ).
querySortList	The list of attributes and the sort orders, based on which the query results are returned.
numMatches	A Boolean value indicating whether to return the total number of CI and relationship instances that the call matched in the query. TRUE --Return the number of instances that match the query. FALSE --No matched instances to return.

CMDBQueryStruct structure

Comments