IDTSBuffer90.Clone Method

Article
12/03/2008

Creates a private copy of an IDTSBuffer90 object.

Namespace: Microsoft.SqlServer.Dts.Pipeline.Wrapper
Assembly: Microsoft.SqlServer.DTSPipelineWrap (in microsoft.sqlserver.dtspipelinewrap.dll)

Syntax

'Declaration
Function Clone ( _
    <InAttribute> pOwner As IDTSComponentMetaData90 _
) As IDTSBuffer90

IDTSBuffer90 Clone (
    [InAttribute] IDTSComponentMetaData90 pOwner
)

IDTSBuffer90^ Clone (
    [InAttribute] IDTSComponentMetaData90^ pOwner
)

IDTSBuffer90 Clone (
    /** @attribute InAttribute() */ IDTSComponentMetaData90 pOwner
)

function Clone (
    pOwner : IDTSComponentMetaData90
) : IDTSBuffer90

Parameters

pOwner
The IDTSComponentMetaData90 of the component creating the cloned buffer.

Return Value

An IDTSBuffer90 object that is a copy of the original buffer.

Remarks

This method creates a private copy of the calling IDTSBuffer90 object that contains all of the columns and rows of the original. The newly created buffer is private to the component that calls the Clone method, which means that the buffer is not managed or monitored by the IDTSBufferManager90. The IDTSBuffer90 must be locked, and cannot be an output buffer, which is a buffer provided to a component in the PrimeOutput method. If the buffer is an output buffer, a DTS_E_BUFFERISNOTPRIMEOUTPUT exception occurs. If the buffer is not locked, a DTS_E_BUFFERNOTLOCKED exception occurs.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms