RFX_Binary_Bulk

Article
03/04/2013

Transférer plusieurs lignes de données byte d'une colonne d'une source de données ODBC à un tableau correspondante dans CRecordsetobjet dérivé.

void RFX_Binary_Bulk(
   CFieldExchange* pFX,
   LPCTSTR szName,
   BYTE** prgByteVals,
   long** prgLengths,
   int nMaxLength 
);

Paramètres

pFX
Un pointeur vers un objet CFieldExchange.Cet objet contient des informations pour définir le contexte pour chaque appel de la fonction.Pour plus d'informations, consultez l'article Record field exchange : Comment le fonctions RFX.
szName
Le nom d'une colonne de données.
prgByteVals
Un pointeur vers un tableau de valeurs de BYTE .Ce tableau stockera des données à transférer de la source de données vers le recordset.
prgLengths
Pointeur vers un tableau de longs entiers.Ce tableau stockera la longueur en octets de chaque valeur du tableau désignée par prgByteVals.Notez que la valeur SQL_NULL_DATA sera signalée si l'élément de données correspondant contient une valeur NULL.Pour plus d'informations, consultez la fonction API ODBC SQLBindCol du guide ODBC sdkprogrammer' s Reference.
nMaxLength
Le maximum de laisser à la longueur des valeurs stockées dans le tableau désignée par prgByteVals.Pour s'assurer que les données ne seront pas tronquées, passez une valeur assez grand pour recevoir le plus grand élément de données attendues.

Notes

La colonne de source de données peut avoir un type ODBC de SQL_BINARY, de SQL_VARBINARY, ou de SQL_LONGVARBINARY.Le recordset doit définir des données membres de champ de type pointeur à BYTE.

Si vous initialisez prgByteVals et prgLengths à NULL, les tableaux qu'elles indiquent sont alloués automatiquement, avec des tailles égale à la taille du jeu de lignes.

[!REMARQUE]

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

Pour plus d'informations, consultez les articles recordset : Extraction globale d'enregistrements (ODBC) et Record field exchange (RFX).