IEnumCERTVIEWCOLUMN::Clone method (certview.h)

Article
02/22/2024

The Clone method creates a copy of the column-enumeration sequence.

Syntax

HRESULT Clone(
  [out] IEnumCERTVIEWCOLUMN **ppenum
);

Parameters

[out] ppenum

A pointer to a pointer of IEnumCERTVIEWCOLUMN type. This method will fail if the ppenum is NULL.

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 cloned column-enumeration sequence object.

Remarks

The column-enumeration sequence is obtained by a call to the IEnumCERTVIEWROW::EnumCertViewColumn method.

Examples

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
IEnumCERTVIEWCOLUMN * pEnumCol2 = NULL;
HRESULT    hr;
hr = pEnumCol->Clone(&pEnumCol2);
if (S_OK != hr)
    printf("Unable to clone IEnumCERTVIEWCOLUMN\n");
else
{
    // use cloned object as needed
    // ...
    // done using cloned object, free memory
}
if (NULL != pEnumCol2)
    pEnumCol2->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

Share via