IEnumCERTVIEWCOLUMN::Reset method (certview.h)
The Reset method moves to the beginning of the column-enumeration sequence.
Syntax
HRESULT Reset();
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 IEnumCERTVIEWCOLUMN::Next method to reference the first column in the enumeration. After this second call is made, the information in the column can be obtained by calling one of the following methods:
- IEnumCERTVIEWCOLUMN::GetName: Retrieves the nonlocalized name of the column.
- IEnumCERTVIEWCOLUMN::GetDisplayName: Retrieves the localized name of the column.
- IEnumCERTVIEWCOLUMN::GetValue: Retrieves the data in the column.
- IEnumCERTVIEWCOLUMN::GetType: Retrieves the type of data in the column.
- IEnumCERTVIEWCOLUMN::GetMaxLength: Retrieves the maximum length, in bytes, of the column.
Examples
// 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_OK == pEnumCol->Next(&Index))
{
// Use each column as needed.
}
}
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | certview.h (include Certsrv.h) |
| Library | Certidl.lib |
| DLL | Certadm.dll |
See also
IEnumCERTVIEWCOLUMN::GetDisplayName