Partager via

  • Article

Structure SSVARIANT

La structure SSVARIANT, qui est définie dans sqlncli.h, correspond à une valeur DBTYPE_SQLVARIANT dans le fournisseur OLE DB SQL Server Native Client.

SSVARIANT est une union de discrimination. En fonction de la valeur du membre vt, le consommateur peut identifier le membre à lire. Les valeurs vt correspondent aux types de données SQL Server. Par conséquent, la structure SSVARIANT peut contenir tout type SQL Server. Pour plus d'informations sur la structure des données pour les types OLE DB standard, consultez Type Indicators (en anglais).

Notes

Lorsque DataTypeCompat==80, plusieurs sous-types SSVARIANT deviennent des chaînes. Par exemple, les valeurs vt suivantes apparaissent dans SSVARIANT en tant que VT_SS_WVARSTRING :

  • VT_SS_DATETIMEOFFSET

  • VT_SS_DATETIME2

  • VT_SS_TIME2

  • VT_SS_DATE

Lorsque DateTypeCompat == 0, ces types s'affichent sous leur forme native.

Pour plus d'informations sur SSPROP_INIT_DATATYPECOMPATIBILITY, consultez Utilisation de mots clés de chaîne de connexion avec SQL Server Native Client.

Le fichier sqlncli.h contient des macros d'accès de type Variant qui simplifient l'annulation de la référence des types de membres dans la structure SSVARIANT. Un exemple est V_SS_DATETIMEOFFSET, que vous pouvez utiliser comme suit :

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

Pour obtenir le jeu complet de macros d'accès pour chaque membre de la structure SSVARIANT, consultez le fichier sqlncli.hi.

Le tableau ci-dessous décrit les membres de la structure SSVARIANT :

Membre

Indicateur de type OLE DB

Type de données OLE DB C

Valeur vt

Commentaires

vt

SSVARTYPE

Spécifie le type de valeur contenu dans la structure SSVARIANT.

bTinyIntVal

DBTYPE_UI1

BYTE

VT_SS_UI1

Prend en charge le type de données tinyintSQL Server.

sShortIntVal

DBTYPE_I2

SHORT

VT_SS_I2

Prend en charge le type de données smallintSQL Server.

lIntVal

DBTYPE_I4

LONG

VT_SS_I4

Prend en charge le type de données intSQL Server.

llBigIntVal

DBTYPE_I8

LARGE_INTEGER

VT_SS_I8

Prend en charge le type de données bigintSQL Server.

fltRealVal

DBTYPE_R4

float

VT_SS_R4

Prend en charge le type de données realSQL Server.

dblFloatVal

DBTYPE_R8

double

VT_SS_R8

Prend en charge le type de données floatSQL Server.

cyMoneyVal

DBTYPE_CY

LARGE_INTEGER

VT_SS_MONEY VT_SS_SMALLMONEY 

Prend en charge les types de données money et smallmoneySQL Server.

fBitVal

DBTYPE_BOOL

VARIANT_BOOL

VT_SS_BIT

Prend en charge le type de données bitSQL Server.

rgbGuidVal

DBTYPE_GUID

GUID

VT_SS_GUID

Prend en charge le type de données uniqueidentifierSQL Server.

numNumericVal

DBTYPE_NUMERIC

DB_NUMERIC

VT_SS_NUMERIC

Prend en charge le type de données numericSQL Server.

dDateVal

DBTYPE_DATE

DBDATE

VT_SS_DATE

Prend en charge le type de données dateSQL Server.

tsDateTimeVal

DBTYPE_DBTIMESTAMP

DBTIMESTAMP

VT_SS_SMALLDATETIME VT_SS_DATETIME VT_SS_DATETIME2

Prend en charge les types de données smalldatetime, datetime et datetime2SQL Server.

Time2Val

DBTYPE_DBTIME2

DBTIME2

VT_SS_TIME2

Prend en charge le type de données timeSQL Server.

Inclut les membres suivants :

tTime2Val (DBTIME2)

bScale (BYTE) Spécifie l'échelle de la valeur tTime2Val.

DateTimeVal

DBTYPE_DBTIMESTAMP

DBTIMESTAMP

VT_SS_DATETIME2

Prend en charge le type de données datetime2SQL Server.

Inclut les membres suivants :

tsDataTimeVal (DBTIMESTAMP)

bScale (BYTE) Spécifie l'échelle de la valeur tsDataTimeVal.

DateTimeOffsetVal

DBTYPE_DBTIMESTAMPOFSET

DBTIMESTAMPOFFSET

VT_SS_DATETIMEOFFSET

Prend en charge le type de données datetimeoffsetSQL Server.

Inclut les membres suivants :

tsoDateTimeOffsetVal (DBTIMESTAMPOFFSET)

bScale (BYTE) Spécifie l'échelle de la valeur tsoDateTimeOffsetVal.

NCharVal

Aucun indicateur de type OLE DB correspondant.

struct _NCharVal

VT_SS_WVARSTRING,

VT_SS_WSTRING

Prend en charge les types de données nchar et nvarcharSQL Server.

Inclut les membres suivants :

sActualLength (SHORT) Spécifie la longueur réelle de la chaîne vers laquelle pwchNCharVal pointe. N'inclut pas le zéro de fin.

sMaxLength (SHORT) Spécifie la longueur maximale de la chaîne vers laquelle pwchNCharVal pointe.

pwchNCharVal (WCHAR *) Pointeur vers la chaîne.

Membres non utilisés : rgbReserved, dwReserved et pwchReserved.

CharVal

Aucun indicateur de type OLE DB correspondant.

struct _CharVal

VT_SS_STRING,

VT_SS_VARSTRING

Prend en charge les types de données char et varcharSQL Server.

Inclut les membres suivants :

sActualLength (SHORT) Spécifie la longueur réelle de la chaîne vers laquelle pchCharVal pointe. N'inclut pas le zéro de fin.

sMaxLength (SHORT) Spécifie la longueur maximale de la chaîne vers laquelle pchCharVal pointe.

pchCharVal (CHAR *) Pointeur vers la chaîne.

Membres non utilisés :

rgbReserved, dwReserved et pwchReserved.

BinaryVal

Aucun indicateur de type OLE DB correspondant.

struct _BinaryVal

VT_SS_VARBINARY,

VT_SS_BINARY

Prend en charge les types de données binary et varbinarySQL Server.

Inclut les membres suivants :

sActualLength (SHORT) Spécifie la longueur réelle des données vers lesquelles prgbBinaryVal pointe.

sMaxLength (SHORT) Spécifie la longueur maximale des données vers lesquelles prgbBinaryVal pointe.

prgbBinaryVal (BYTE *) Pointeur vers les données binaires.

Membre non utilisé : dwReserved.

UnknownType

UNUSED

UNUSED

UNUSED

UNUSED

BLOBType

UNUSED

UNUSED

UNUSED

UNUSED

Voir aussi

Concepts

Types de données (OLE DB)