IVsEnumOutputs.Clone Method

Article
03/06/2013

Creates another enumerator that contains the same enumeration state as the current one.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
Function Clone ( _
    <OutAttribute> ByRef ppIVsEnumOutputs As IVsEnumOutputs _
) As Integer

int Clone(
    out IVsEnumOutputs ppIVsEnumOutputs
)

int Clone(
    [OutAttribute] IVsEnumOutputs^% ppIVsEnumOutputs
)

abstract Clone : 
        ppIVsEnumOutputs:IVsEnumOutputs byref -> int

function Clone(
    ppIVsEnumOutputs : IVsEnumOutputs
) : int

Parameters

ppIVsEnumOutputs
Type: Microsoft.VisualStudio.Shell.Interop.IVsEnumOutputs%
[out] Pointer to the cloned IVsEnumOutputs interface, a new enumerator that is set to the same state as the current IVsEnumOutputs interface. If the method is unsuccessful, the value of ppIVsEnumOutputs is undefined.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell.idl:

HRESULT IVsEnumOutputs::Clone(
   [out] IVsEnumOutputs **ppIVsEnumOutputs
);

Using this method, the environment can record a particular point in the enumeration sequence and return to that point later. The new enumerator works on the same set of output items as the original enumerator.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.