RFX_Binary_Bulk

Статья
06/10/2015

Перемещает несколько строк байтовых данных из столбца источника данных ODBC в соответствующий массив в CRecordset- производный объект.

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

Параметры

pFX
Указатель на объект CFieldExchange. Этот объект содержит сведения для того, чтобы определить контекст для каждого вызова функции. Дополнительные сведения см. в статье Обмен полями записей: Принцип работы RFX.
szName
Имя столбца данных.
prgByteVals
Указатель на массив значений byte. Этот массив будет хранить данные для передачи из источника данных в набор записей.
prgLengths
Указатель на массив длинных целых чисел. Этот массив будет храниться длина в байтах каждого значения в массиве указанных в prgByteVals. Обратите внимание, что значение SQL_NULL_DATA будет храниться, если соответствующий элемент данных содержит значение NULL. Дополнительные сведения см. в разделе функцию интерфейса API ODBC SQLBindCol в справочнике программиста ODBC SDK.
nMaxLength
Максимально допустимые длина значений, хранящихся в указанном массиве. prgByteVals. Чтобы убедиться, что данные не будут усечены, передайте значение достаточно большое, чтобы вместить максимальный элемент данных ожидалось.

Заметки

Столбец источника данных может иметь тип ODBC SQL_BINARY, SQL_VARBINARY или SQL_LONGVARBINARY. Набор записей должен определять элемент поля данных указателя типа в byte.

При инициализации prgByteVals и prgLengths значение NULL, то они указывают на массивы будут выделены автоматически с размерами не размеру набора строк.

Примечание

Блочный обмен полей записей только передает данные из источника данных в объект набора записей.Чтобы сделать этот набор записей обновляемый необходимо использовать функцию интерфейса API ODBC SQLSetPos.

Дополнительные сведения см. в статьях Набор записей. Пакетная выборка строк (ODBC) и Обмен полями записей (RFX).