Purpose:
The DXResultSetCursorDES class represents a result set cursor for Domino Extended Search (DES).
Methods:
BOOL isValid();
BOOL isOpen();
BOOL isBegin();
BOOL isEnd();
BOOL isInBetween();
Returns TRUE if cursor is positioned in between data objects in the result set.
long getPosition();
void setPosition(long position, const VARIANT FAR& value);
setToNext();
Sets the cursor to point to the position of the next data object.
LPDISPATCH fetchObject();
Fetches the element of the result set at the current position and return it as a DXDDODES. The returned LPDISPATCH pointer contains a DXDDODES object.
LPDISPATCH fetchNext();
Fetches the next element of the result set and returns it as a DXDDODES. The returned LPDISPATCH pointer contains a DXDDODES object.
BOOL fetchNextN(long how_many, LPDISPATCH collection);
Fetches next N elements of the result set and insert them into the given collection. Returns true if there is at least one data object returned. The input parameter LPDISPATCH pointer contains a DXSequentialCollectionDES object.
VARIANT fetchObjectByName(LPCTSTR dataItemName);
VARIANT fetchNextByName(LPCTSTR dataItemName);
BOOL fetchNextNByName(LPCTSTR dataItemName, long how_many, VARIANT* array, long arraySize);
Fetches values of the next n data objects by data item name and insert them into the given array. The size of array and how_many input parameter determine how many values are put into the array. Returns true if there is at least one value returned.
LPDISPATCH findObject(long position, LPCTSTR predicate);
Finds the data object which satisfies the given predicate, move the cursor to that position, fetch and return the data object. The returned LPDISPATCH pointer contains a DXDDODES object.
open();
close();
destroy();
Destroys the result set cursor. This method allows for cleanup.
BSTR datastoreName();
BSTR datastoreType();
long cardinality();
Returns the number of results.
(c) Copyright International Business Machines Corporation 1996, 2002. IBM Corp. All rights reserved.