IDTSRuntimeComponent90.PrimeOutput Method

Article
12/03/2008

Called during package execution for components that add rows to the IDTSBuffer90; including source components and transformation components with asynchronous IDTSOutput90 objects. The developer needs to supply the code that adds the rows to the output buffers.

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

Syntax

'Declaration
<DispIdAttribute(14)> _
Sub PrimeOutput ( _
    <InAttribute> lOutputs As Integer, _
    <InAttribute> ByRef lOutputIDs As Integer, _
    <InAttribute> ByRef pIDTSBufferOutputs As IDTSBuffer90 _
)

[DispIdAttribute(14)] 
void PrimeOutput (
    [InAttribute] int lOutputs,
    [InAttribute] ref int lOutputIDs,
    [InAttribute] ref IDTSBuffer90 pIDTSBufferOutputs
)

[DispIdAttribute(14)] 
void PrimeOutput (
    [InAttribute] int lOutputs, 
    [InAttribute] int% lOutputIDs, 
    [InAttribute] IDTSBuffer90^% pIDTSBufferOutputs
)

/** @attribute DispIdAttribute(14) */ 
void PrimeOutput (
    /** @attribute InAttribute() */ int lOutputs, 
    /** @attribute InAttribute() */ /** @ref */ int lOutputIDs, 
    /** @attribute InAttribute() */ /** @ref */ IDTSBuffer90 pIDTSBufferOutputs
)

JScript does not support passing value-type arguments by reference.

Parameters

lOutputs
The number of elements in the outputIDs and buffers arrays.

lOutputIDs
An array of IDTSOutput90 IDs.

pIDTSBufferOutputs
An array of IDTSBuffer90 objects.

Remarks

The number of elements in the lOutputs and pIDTSBufferOutputs array is determined by the number of IDTSOutput90 objects in the IDTSOutputCollection90 of the component connected to an IDTSPath90 object.

Each element in the lOutputIDs array has a IDTSBuffer90 at the same index in the pIDTSBufferOutputs array.

Rows are added to the PipelineBuffer by calling the AddRow method, and when finished, the SetEndOfRowset method is called to notify the data flow task that the component is finished adding rows.

PrimeOutput is called for components whose SynchronousInputID property is set to zero.

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