void RFX_Binary_Bulk (objet CFieldExchange * pFX, LPCTSTR szName, BYTE ** prgByteVals, long ** prgLengths, int nMaxLength );
Paramètres
pFX
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 : fonctionnement de RFX dans le Guide du programmeur Visual C++.
szName
Le nom d'une colonne de données.
prgByteVals
Pointeur vers un tableau de valeurs d'octets . Ce tableau va stocker les données à être transférée de la source de données pour le jeu d'enregistrements.
prgLengths
Pointeur vers un tableau d'entiers longs. Ce tableau va stocker la longueur en octets de chaque valeur dans le tableau indiqué par prgByteVals. Notez que la valeur SQL_NULL_DATA est conservée si l'élément correspondant des données contient une valeur Null. Pour plus de détails, reportez-vous à la fonction API ODBC SQLBindCol dans la référence du programmeur ODBC SDK.
nMaxLength
La quantité maximale autorisée la longueur des valeurs stockées dans le tableau indiqué par prgByteVals. Pour s'assurer que les données ne seront pas tronquées, transmettez une valeur suffisamment grande pour accueillir le plus grand élément de données que vous attendez.
Remarques
La fonction RFX_Binary_Bulk transfère plusieurs lignes de données d'octets d'une colonne d'une source de données ODBC à un tableau correspondant à un objet CRecordset-objet dérivé. La colonne de source de données peut avoir un type ODBC SQL_BINARY, SQL_VARBINARYou SQL_LONGVARBINARY. Le jeu d'enregistrements doit définir un membre de données de champ de type pointeur d'octet.
Si vous initialisez prgByteVals et prgLengths à NULL, puis les tableaux, qu'ils seront attribuées automatiquement, avec une taille égale à la taille de l'ensemble de lignes.
&Notenbsp ; RFX en bloc seulement transfère les données de la source de données à l'objet recordset. Afin de rendre votre jeu d'enregistrements de mise à jour, vous devez utiliser la fonction API ODBC SQLSetPos. Pour obtenir un exemple de comment procéder, consultez l'exemple DBFETCH.
Pour plus d'informations, consultez les articles jeu d'enregistrements : extraction de dossiers en vrac (ODBC) et Record Field Exchange ((RFX)) dans le Guide du programmeur Visual C++.
Exemple
Voir RFX_Text_Bulk.
Voir aussi ;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