IEnumCERTVIEWROW::Reset

[This is preliminary documentation and subject to change.]

The Reset method resets the IEnumCERTVIEWROW enumeration sequence to the beginning.

[VB] Reset();
 
[JAVA] Reset();
 
[C++] HRESULT Reset();
 

Return Values

[C++] The return value is an HRESULT. A value of S_OK indicates success.

Remarks

Upon successful completion of this function, the IEnumCERTVIEWROW object will be positioned to the beginning the Certificate Server view's rows. To access the data in the first row after calling the IEnumCERTVIEWROW Reset method, call the IEnumCERTVIEWROW Next method. After a valid row has been referenced by the IEnumCERTVIEWROW object, data can be retrieved through calls to IEnumCERTVIEWCOLUMN.

Example

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT              hr;
LONG                 Index;

// ensure enumerator is at first row
hr = pEnumRow->Reset();
if ( FAILED( hr ) )
    printf("Failed to Reset\n");
else
{
    printf("Reset to beginning\n");
    // retrieve first record
    hr = pEnumRow->Next( &Index );
    // examine hr for success and process row
    // ...
}
 

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in certview.h.
  Import Library: Use certidl.lib.

See Also

IEnumCERTVIEWROW::Next, IEnumCERTVIEWROW::Skip