Reset Method
Collapse the table of content
Expand the table of content

IEnumCERTVIEWROW::Reset method

The Reset method moves to the beginning of the row-enumeration sequence.

Syntax


HRESULT Reset();

Parameters

This method has no parameters.

Return value

VB

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

Upon successful completion of this method, call the IEnumCERTVIEWROW::Next method to reference the first row in the enumeration.

After this second call is made, the columns, attributes, and extensions associated with the certificate in the row can be enumerated using the methods of the following interfaces:

Examples


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

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Certview.h (include Certsrv.h)

Library

Certidl.lib

DLL

Certadm.dll

IID

IID_IEnumCERTVIEWROW is defined as d1157f4c-5af2-11d1-9bdc-00c04fb683fa

See also

IEnumCERTVIEWATTRIBUTE
IEnumCERTVIEWCOLUMN
IEnumCERTVIEWEXTENSION
IEnumCERTVIEWROW

 

 

Show:
© 2016 Microsoft