IEnumCERTVIEWROW::EnumCertViewColumn method (certview.h)
The EnumCertViewColumn method obtains an instance of a column-enumeration sequence for the current row of the row-enumeration sequence.
Syntax
HRESULT EnumCertViewColumn(
[out] IEnumCERTVIEWCOLUMN **ppenum
);
Parameters
[out] ppenum
A pointer to a pointer of IEnumCERTVIEWCOLUMN type.
Return value
C++
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.
VB
The return value is a column-enumeration sequence object.Remarks
The column-enumeration sequence obtained by this call can be used to enumerate the columns associated with the certificate in the current row. This enumeration can be accessed through the methods of the IEnumCERTVIEWCOLUMN interface.
To reference a different row, call one of the following methods to navigate through the row-enumeration sequence:
- IEnumCERTVIEWROW::Reset: Moves to the beginning of the enumeration sequence.
- IEnumCERTVIEWROW::Next: Moves to the next row in the enumeration sequence.
- IEnumCERTVIEWROW::Skip: Skips a specified number of rows.
Examples
// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT hr;
LONG Index;
IEnumCERTVIEWCOLUMN * pEnumCol = NULL;
// obtain enumerator for columns
hr = pEnumRow->EnumCertViewColumn(&pEnumCol);
if ( FAILED( hr ))
{
printf("Failed EnumCertViewColumn - %x\n", hr );
goto error;
}
// enumerate each column
while (S_OK == pEnumCol->Next(&Index))
{
// Use this column as needed.
}
error:
// Free resources.
if ( NULL != pEnumCol )
pEnumCol->Release();
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 |