IEnumCERTVIEWROW::Next

[This is preliminary documentation and subject to change.]

The Next method positions the IEnumCERTVIEWROW object to the next row.

[VB] Long Next();
 
[JAVA] int Next();
 
[C++] HRESULT Next(
  LONG *pIndex   // out
);

Parameters

[C++] pIndex: Pointer to LONG variable that will contain the index value of the next row that will be referenced by the IEnumCERTVIEWROW object. If there are no more rows to enumerate, this variable will be set to – 1. This function will fail if pIndex is NULL.

Return Values

[VB][JAVA] The return value is the index value of the next row that will be referenced by the IEnumCERTVIEWROW object. If there are no more rows to enumerate, the return value will be – 1.

[C++] The return value is an HRESULT. A value of S_OK indicates success and that the next row is now being referenced by the IEnumCERTVIEWROW object. If there are no more rows to enumerate, S_FALSE is returned, and pIndex will point to a value of – 1.

Remarks

Upon successful completion of this function, the IEnumCERTVIEWROW object will have moved to the next data row. Once the row is referenced, the column data can be retrieved through calls to IEnumCERTVIEWCOLUMN.

Example

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
LONG                 Index;
LONG                 nCount;

// ensure enumerator is at first row
if ( FAILED (pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // count the database records by enumerating the rows
    while ( S_FALSE != pEnumRow->Next( &Index ) )
        nCount++;
    // display number of records
    printf("Number of records is %d\n", nCount );
}

QuickInfo