IEnumCERTVIEWATTRIBUTE::Reset

[This is preliminary documentation and subject to change.]

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

[VB] Reset();
 
[JAVA] Reset();
 
[C++] 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 IEnumCERTVIEWATTRIBUTE object will be positioned to the beginning of the object's attributes. To reference the first attribute after calling the IEnumCERTVIEWATTRIBUTE Reset method, call the IEnumCERTVIEWATTRIBUTE Next method. When a valid attribute is referenced by the IEnumCERTVIEWATTRIBUTE object, data can be retrieved through the IEnumCERTVIEWATTRIBUTE methods GetName and GetValue.

Example

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
HRESULT     hr;
LONG        Index;

hr = pEnumAttr->Reset();
if ( S_OK != hr )
    printf("Unable to reset pEnumAttr - %x\n", hr );
    // call appropriate error handler / exit routine
else
{
    // reset to beginning of attributes again
    while ( S_FALSE != pEnumAttr->Next( &Index ) )
    {
        // do something with each attribute
    }
}
 

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

IEnumCERTVIEWATTRIBUTE::Next, IEnumCERTVIEWATTRIBUTE::Skip