RFX_Date_Bulk

Article
06/10/2015

Transfère plusieurs rangées de données TIMESTAMP_STRUCT d'une colonne d'une source de données ODBC à un tableau correspondant dans un objet dérivé de CRecordset.

void RFX_Date_Bulk( 
   CFieldExchange* pFX, 
   LPCTSTR szName, 
   TIMESTAMP_STRUCT** prgTSVals, 
   long** prgLengths  
);

Paramètres

pFX
Un pointeur vers un objet CFieldExchange. Cet objet contient des informations pour définir le contexte de chaque appel de la fonction. Pour plus d'informations, consultez l'article Échange de champs d'enregistrement : Comment RFX fonctionne.
szName
Le nom d'une colonne de données.
prgTSVals
Pointeur vers un tableau de valeurs de TIMESTAMP_STRUCT. Ce tableau stocke les données à transférer de la source de données au jeu d'enregistrements. Pour plus d'informations sur le type de données de TIMESTAMP_STRUCT, consultez la rubrique « types de données C » dans l'annexe D duguide de référence du programmeur ODBC.
prgLengths
Pointeur vers un tableau d'entiers de type long. Cette table stocke la longueur en octets de toutes les valeurs dans le tableau vers lequel pointe prgTSVals. Notez que la valeur SQL_NULL_DATA est enregistrée si l'élément de données correspondante contient une valeur NULL. Pour plus d'informations, consultez la fonction SQLBindCol de l'API ODBC dans le guide de référence du programmeur ODBC.

Notes

La colonne de source de données peut avoir un type ODBC de SQL_DATE, de SQL_TIME, ou de SQL_TIMESTAMP. L'ensemble d'enregistrements doit définir un membres de données de champ de pointeur de type sur TIMESTAMP_STRUCT.

Si vous initialisez prgTSVals et prgLengths sur NULL, les tableaux vers lesquels ils pointent sont alloués automatiquement, avec des tailles égales à la taille de l'ensemble de lignes.

Notes

Le mécanisme RFX en bloc transfère seulement un jeu de lignes de données entre la source de données et l'objet recordset.Pour rendre votre ensemble modifiable, vous devez utiliser la fonction SQLSetPos de l'API ODBC.

Pour plus d'informations, consultez les articles Record Field Exchange (RFX) et Recordset : extraction globale d'enregistrements (ODBC).