Partager via


RFX_Binary_Bulk

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).

Exemple

Consultez RFX_Text_Bulk.

Configuration requise

Header: afxdb.h

Voir aussi

Référence

RFX_Bool_Bulk

RFX_Byte_Bulk

RFX_Date_Bulk

RFX_Double_Bulk

RFX_Int_Bulk

RFX_Long_Bulk

RFX_Single_Bulk

RFX_Text_Bulk

CFieldExchange::SetFieldType

Concepts

Macro MFC et Globals