Столбец данных

Внимание

Эта функция будет удалена в будущей версии Windows. Избегайте использования этой функции в новых рабочих областях разработки и планируете изменять приложения, которые в настоящее время используют эту функцию. Корпорация Майкрософт рекомендует использовать функции курсора драйвера.

Библиотека курсоров создает буфер в кэше для каждого буфера данных, привязанного к результирующем набору с SQLBindCol. Он использует значения в этих буферах для создания предложения WHERE , когда он эмулирует позиционированный оператор обновления или удаления. Он обновляет эти буферы из буферов набора строк при получении данных из источника данных и при выполнении позиционированных инструкций обновления.

Когда библиотека курсоров обновляет кэш из буферов набора строк, она передает данные в соответствии с типом данных C, указанным в SQLBindCol. Например, если тип данных C буфера набора строк SQL_C_SLONG, библиотека курсоров передает четыре байта данных; Если значение SQL_C_CHAR и BufferLength равно 10, библиотека курсоров передает 10 байт данных. Библиотека курсоров не выполняет проверку типа или преобразование данных, которые он передает.

Заметка

Библиотека курсоров не обновляет кэш столбца, если *StrLen_or_IndPtr в соответствующем буфере набора строк SQL_DATA_AT_EXEC или результат макроса SQL_LEN_DATA_AT_EXEC.

При обновлении столбца при необходимости исходный источник данных пустой панели содержит символьные данные фиксированной длины и двоичные данные с нулевой длиной. Например, источник данных сохраняет "Smith" в столбце CHAR(10) как "Smith". Библиотека курсоров не содержит пустой или нулевой панели данных в буферах набора строк при копировании этих данных в кэш после выполнения инструкции обновления с позицией. Таким образом, если приложению требуется, чтобы значения в кэше библиотеки курсоров были пустыми или отсчитываются от нуля, перед выполнением позиционированного оператора обновления необходимо пустой или нулевой панели значения в буферах набора строк.