• Article

GetColumnSQLVARIANTDataType Method

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 GetColumnSQLVARIANTDataTypemethod retrieves the underlying data type of the specified sql_variant column.

Syntax

object.GetColumnSQLVARIANTDataType( Row, Column, ObjName)as String

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • Row
    Long integer that identifies a row by ordinal position.

  • Column
    Long integer that identifies a column by ordinal position.

  • ObjName
    String that specifies a table or view name.

Prototype (C/C++)

HRESULT GetColumnSQLVARIANTDataType(
long lRow, 
long lColumn, 
SQLDMO_LPCSTR ObjName, 
SQLDMO_LPBSTR pRetVal);

Note

SQL Distributed Management Objects (SQL-DMO) strings are returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

Remarks

An application written in C++ can use the information returned by the GetColumnSQLVARIANTDataType and GetColumnSQLVARIANTLength methods to allocate an appropriate amount of buffer space in which to manipulate the data retrieved from a sql_variantcolumn.

The application can then call GetColumnSQLVARIANT to return the contents of a sql_variant column as an array. The application can then cast the contents of the array into the required data type.

Note

If an application calls GetColumnSQLVARIANTDataType on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.

Applies To:

QueryResults2 Object