[This is preliminary documentation and subject to change.]
The Reset method resets the IEnumCERTVIEWEXTENSION 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 IEnumCERTVIEWEXTENSION object will be positioned to the beginning of the object's extensions. To reference the first extension after calling the IEnumCERTVIEWEXTENSION Reset method, call the IEnumCERTVIEWEXTENSION Next method. When a valid extension is referenced by the IEnumCERTVIEWEXTENSION object, information can be retrieved through calls to the IEnumCERTVIEWEXTENSION methods GetFlags, GetName, and GetValue.
HRESULT hr;
LONG Index;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->Reset();
if ( S_OK != hr )
printf("Unable to reset pEnumExt - %x\n", hr );
// call appropriate error handler / exit routine
else
{
// reset to beginning of extensions again
while ( S_FALSE != pEnumExt->Next( &Index ) )
{
// do something with each extension
}
}
Windows NT: Requires version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in certview.h.
Import Library: Use certidl.lib.
IEnumCERTVIEWEXTENSION::Next, IEnumCERTVIEWEXTENSION::Skip