IDTSBuffer90.GetDataByRef Method

Article
12/03/2008

(Feature deprecated, see Remarks.) Gets a pointer to the data stored in a column in an IDTSBuffer90.

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

Syntax

'Declaration
Function GetDataByRef ( _
    <InAttribute> hRow As Integer, _
    <InAttribute> hCol As Integer _
) As DTP_VARIANT

DTP_VARIANT GetDataByRef (
    [InAttribute] int hRow,
    [InAttribute] int hCol
)

DTP_VARIANT GetDataByRef (
    [InAttribute] int hRow, 
    [InAttribute] int hCol
)

DTP_VARIANT GetDataByRef (
    /** @attribute InAttribute() */ int hRow, 
    /** @attribute InAttribute() */ int hCol
)

function GetDataByRef (
    hRow : int, 
    hCol : int
) : DTP_VARIANT

Parameters

hRow
The handle of the row.

hCol
The handle of the column.

Return Value

Note

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The DTP_VARIANT that contains the data in the column.

Remarks

This method returns a pointer to the data stored in the column specified by the hCol parameter. This pointer is used to directly modify the data in the column specified by hCol instead of calling the GetData method, modifying the data, and then calling SetData.

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