Aracılığıyla paylaş


SSVARIANT yapısı

The SSVARIANT structure, which is defined in sqlncli.h, corresponds to a DBTYPE_SQLVARIANT value in the SQL Server Native istemci OLEDB sağlayıcı.

SSVARIANT discriminating bir birleşim dir.Depending on the value of the vt member, the consumer can determine which member to read.vt values correspond to SQL Server data types.Bu nedenle, SSVARIANT SQL Server her türlü yapısı basılı tutun. Standart OLE DB türleri için veri yapısı hakkında daha fazla bilgi için bkz: Tür göstergeleri.

Remarks

Zaman DataTypeCompat 80 == birkaç SSVARIANT alt türlerinden dizeleri olur. Vt değerler aşağıdaki gibi görünür SSVARIANT VT_SS_WVARSTRING:

  • vt_ss_datetimeoffset

  • VT_SS_DATETİME2

  • VT_SS_TİME2

  • vt_ss_date

Zaman DateTypeCompat == 0'da, bu tür, kendi yerel formunda görüntülenir.

SSPROP_INIT_DATATYPECOMPATIBILITY hakkında daha fazla bilgi için bkz: SQL Server ile yerel istemci bağlantı dizesi anahtar sözcükler kullanma.

Sqlncli.h dosya üye türlerinde kaldırma kolaylaştıran varyant erişim makroları SSVARIANT yapısı. Kullanabileceğiniz gibi V_SS_DATETIMEOFFSET buna bir örnektir:

memcpy(&V_SS_DATETIMEOFFSET(pssVar).tsoDateTimeOffsetVal, pDTO, cbNative);
V_SS_DATETIMEOFFSET(pssVar).bScale = bScale;

Tam erişim makroları kümesinin her üye için SSVARIANT Yapı, sqlncli.hi dosyasına bakın.

Üyeleri, aşağıdaki tabloda açıklanmıştır SSVARIANT yapısı:

Üye

OLE DB türü göstergesi

OLE DB C veri türü

VT değeri

Açıklamalar

vt

ssvartype

Içerdiği değer türünü belirtir SSVARIANT Yapı.

bTinyIntVal

DBTYPE_Uİ1

BYTE

VT_SS_UI1

Supports the tinyintSQL Server data type.

sShortIntVal

DBTYPE_İ2

SHORT

VT_SS_I2

Supports the smallintSQL Server data type.

lIntVal

DBTYPE_İ4

LONG

VT_SS_I4

Supports the intSQL Server data type.

llBigIntVal

DBTYPE_İ8

LARGE_INTEGER

VT_SS_I8

Supports the bigintSQL Server data type.

fltRealVal

DBTYPE_R4

float

VT_SS_R4

Supports the realSQL Server data type.

dblFloatVal

DBTYPE_R8

double

VT_SS_R8

Supports the floatSQL Server data type.

cyMoneyVal

dbtype_cy

LARGE_INTEGER

VT_SS_MONEY VT_SS_SMALLMONEY 

Supports the money and smallmoneySQL Server data types.

fBitVal

dbtype_bool

VARIANT_BOOL

VT_SS_BIT

Supports the bitSQL Server data type.

rgbGuidVal

dbtype_guid

GUID

VT_SS_GUID

Supports the uniqueidentifierSQL Server data type.

numNumericVal

dbtype_numeric

DB_NUMERIC

VT_SS_NUMERIC

Supports the numericSQL Server data type.

dDateVal

dbtype_date

DBDATE

VT_SS_DATE

Supports the dateSQL Server data type.

tsDateTimeVal

dbtype_dbtimestamp

DBTIMESTAMP

VT_SS_SMALLDATETIME VT_SS_DATETIME VT_SS_DATETIME2

Supports the smalldatetime, datetime, and datetime2SQL Server data types.

Time2Val

DBTYPE_DBTİME2

DBTIME2

VT_SS_TIME2

Supports the timeSQL Server data type.

Aşağıdaki üyelere içerir:

tTime2Val (DBTIME2)

bScale (BYTE) Için Ölçek belirtir tTime2Val Değer.

DateTimeVal

dbtype_dbtimestamp

DBTIMESTAMP

VT_SS_DATETIME2

Supports the datetime2SQL Server data type.

Aşağıdaki üyelere içerir:

tsDataTimeVal (dbtimestamp)

bScale (BYTE) Için Ölçek belirtir tsDataTimeVal Değer.

DateTimeOffsetVal

dbtype_dbtimestampofset

DBTIMESTAMPOFFSET

VT_SS_DATETIMEOFFSET

Supports the datetimeoffsetSQL Server data type.

Aşağıdaki üyelere içerir:

tsoDateTimeOffsetVal (DBTIMESTAMPOFFSET)

bScale (BYTE) Için Ölçek belirtir tsoDateTimeOffsetVal Değer.

NCharVal

Ilgili hiçbir OLE DB türü göstergesi.

struct _NCharVal

VT_SS_WVARSTRING,

VT_SS_WSTRING

Supports the nchar and nvarcharSQL Server data types.

Aşağıdaki üyelere içerir:

sActualLength (SHORT) Belirtir uzunluğu için için dize hangi pwchNCharVal puan. Sıfır sonlandırma içermez.

sMaxLength (SHORT) Belirtir için en fazla uzunluk dize hangi pwchNCharVal puan.

pwchNCharVal (WCHAR *) Dize işaretçisi.

Kullanılmayan üyeleri: rgbReserved, dwReserved, ve pwchReserved.

CharVal

Ilgili hiçbir OLE DB türü göstergesi.

struct _CharVal

VT_SS_STRING,

VT_SS_VARSTRING

Supports the char and varcharSQL Server data types.

Aşağıdaki üyelere içerir:

sActualLength (SHORT) Için gerçek uzunluğunu belirtir dize hangi pchCharVal puan. Sıfır sonlandırma içermez.

sMaxLength (SHORT) Hangi dizesinin uzunluğu en fazla belirtir pchCharVal puan.

pchCharVal (CHAR *) Dize işaretçisi.

Kullanılmayan üyeleri:

rgbReserved, dwReserved, ve pwchReserved.

BinaryVal

Ilgili hiçbir OLE DB türü göstergesi.

struct _BinaryVal

VT_SS_VARBINARY,

VT_SS_BINARY

Supports the binary and varbinarySQL Server data types.

Aşağıdaki üyelere içerir:

sActualLength (SHORT) Hangi verilerin gerçek uzunluğunu belirtir prgbBinaryVal puan.

sMaxLength (SHORT) Hangi verilerin uzunluğu en fazla belirtir prgbBinaryVal puan.

prgbBinaryVal (BYTE *) Ikili veri işaretçisi.

Kullanılmayan üyesi: dwReserved.

UnknownType

Kullanılmayan

Kullanılmayan

Kullanılmayan

Kullanılmayan

BLOBType

Kullanılmayan

Kullanılmayan

Kullanılmayan

Kullanılmayan

See Also

Concepts