RFX_Binary_Bulk

Статья
02/20/2013

Передает несколько строк из байтовых данных столбца источника данных 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, то они указывают на массивы, будут выбраны автоматически с размерами равными к размеру набора строк.

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