IEnumConnections::Clone

HRESULT IEnumConnections::Clone([out] IEnumConnections **ppEnum);

Creates another connections enumerator with the same state as the current enumerator, which iterates over the same list. This makes it possible to record a point in the enumeration sequence in order to return to that point at a later time.

Argument

Type

Description

ppEnum

IEnumConnections**

[out] The address of the variable to receive the IEnumConnections interface pointer to the newly created enumerator. The caller must release this new enumerator separately from the first enumerator.


Return Value

Meaning

S_OK

Clone creation succeeded.

E_NOTIMPL

Cloning is not supported for this enumerator.

E_POINTER

The address in ppEnum is not valid (such as NULL).

E_UNEXPECTED

An unknown error occurred.

E_OUTOFMEMORY

There is not enough memory to create the clone enumerator.