IDTSBuffer100.Clone Method
Creates a private copy of an IDTSBuffer100 object.
Namespace: Microsoft.SqlServer.Dts.Pipeline.Wrapper
Assembly: Microsoft.SqlServer.DTSPipelineWrap (in Microsoft.SqlServer.DTSPipelineWrap.dll)
Syntax
'Declaration
Function Clone ( _
pOwner As IDTSComponentMetaData100 _
) As IDTSBuffer100
'Usage
Dim instance As IDTSBuffer100
Dim pOwner As IDTSComponentMetaData100
Dim returnValue As IDTSBuffer100
returnValue = instance.Clone(pOwner)
IDTSBuffer100 Clone(
IDTSComponentMetaData100 pOwner
)
IDTSBuffer100^ Clone(
[InAttribute] IDTSComponentMetaData100^ pOwner
)
abstract Clone :
pOwner:IDTSComponentMetaData100 -> IDTSBuffer100
function Clone(
pOwner : IDTSComponentMetaData100
) : IDTSBuffer100
Parameters
- pOwner
Type: Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSComponentMetaData100
The IDTSComponentMetaData100 of the component creating the cloned buffer.
Return Value
Type: Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSBuffer100
An IDTSBuffer100 object that is a copy of the original buffer.
Remarks
This method creates a private copy of the calling IDTSBuffer100 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 IDTSBufferManager100. The IDTSBuffer100 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.