Index

DXResultsDL

Purpose:

This is the class that is used to represent a results collection.

Methods:

init
init(LPDISPATCH ds);

You must call this method following the creation of a DXResultsDL object (except for methods returning a DXResultsDL object). The method initializes the collection object with the datastore. The input parameter LPDISPATCH pointer contains either a DXDatastoreDL object or a DXDatastoreTS object or a DXDatastoreQBIC object.

cardinality
long cardinality();

Returns the number of elements in the collection.

createIterator
LPDISPATCH createIterator();

Creates a iterator to iterate over a collection. The returned LPDISPATCH pointer contains a DXSequentialIteratorDL object.

addElement
addElement(VARIANT element);

Adds an element to the collection.

retrieveElementAt
VARIANT retrieveElementAt(LPDISPATCH where);

Returns the element the iterator is pointing at.

removeElement
removeElementAt(LPDISPATCH where);

Removes the element the iterator is pointing at. The input parameter LPDISPATCH pointer contains a DXSequentialIteratorDL object.

removeAllElements
removeAllElements();

Removes all elements in the collection.

insertElementAt
insertElementAt(VARIANT element, LPDISPATCH where);

Adds a new element, after the element the iterator is currently pointing to. The input parameter LPDISPATCH pointer contains a DXSequentialIteratorDL object.

replaceElementAt
replaceElementAt(VARIANT element, LPDISPATCH where);

Replaces the element the iterator is pointing at. The input parameter LPDISPATCH pointer contains a DXSequentialIteratorDL object.

evaluate
VARIANT evaluate(LPCTSTR query,
                 short ql_type
                 [,VARIANT paramList]);

Evaluates the given query of the given query language type with the optional parameter list of an array of DXNVPairDL objects and returns the results. The value of the returned VARIANT is a DXResultsDL object.

(c) Copyright International Business Machines Corporation 1996, 2002. IBM Corp. All rights reserved.