IEnumCERTVIEWEXTENSION::Reset

[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();
 

Return Values

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

Remarks

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.

Example

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
    }
}
 

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

IEnumCERTVIEWEXTENSION::Next, IEnumCERTVIEWEXTENSION::Skip