Syntax:

HRESULT MoveNext();

Task:

Only used at node level. List & Label requests to move the cursor of the data object to the next row.

Parameter:

None

Return value:

E_NOTIMPL for root objects and E_FAIL in the event of an error. Usually S_OK if successful or S_FALSE if no more data is available.

Hints:

In order for a cursor to be moved, the data object usually has to already exist completely. In the case of an SQL provider, this means that the required query has already been assembled and initiated at this point in time. You should initialize your enumerator exactly now (and not earlier) as MoveNext () is called initially to get the first row of data.