IEnumCERTVIEWCOLUMN::Reset

[This is preliminary documentation and subject to change.]

The Reset method resets the IEnumCERTVIEWCOLUMN 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 IEnumCERTVIEWCOLUMN object will be positioned to the beginning the IEnumCERTVIEWCOLUMN object's columns. To access the data in the first column after calling the IEnumCERTVIEWCOLUMN Reset method, call the IEnumCERTVIEWCOLUMN Next method. When a valid column is being referenced by the IEnumCERTVIWCOLUMN object, data can be retrieved through calls to the IEnumCERTVIEWCOLUMN methods GetName, GetType, and GetValue.

Example

// pEnumCol is previously instantiated IEnumCERTVIEWColumn object
HRESULT    hr;
LONG        Index;
hr = pEnumCol->Reset();
if ( S_OK != hr )
    printf("Unable to reset pEnumCol\n");
    // call appropriate error handler / exit routine
else
{
    // now at the beginning of the columns
    // enumerate each column
    while ( S_FALSE != pEnumCol->Next( &Index ) )
    {
        // do something with each column
    }
}
 

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

IEnumCERTVIEWCOLUMN::Next, IEnumCERTVIEWCOLUMN::Skip