[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();
[C++] The return value is an HRESULT. A value of S_OK indicates success.
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.
// 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
// ...
}
Windows NT: Requires version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in certview.h.
Import Library: Use certidl.lib.
IEnumCERTVIEWROW::Next, IEnumCERTVIEWROW::Skip