Структура JET_RETINFO

  • Статья

Применимо к: Windows | Windows Server

Структура JET_RETINFO

Структура JET_RETINFO содержит необязательные входные и выходные параметры для JetRetrieveColumn. Пустой указатель может передаваться там, где в противном случае был бы передан указатель на эту структуру. Передача пустого указателя аналогична передаче JET_RETINFO с параметром cbStruct sizeof(JET_RETINFO), ibLongValue — равным 0 (нулю), а параметру itagSequence — значение 1.

    typedef struct {
      unsigned long cbStruct;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
    } JET_RETINFO;

Элементы

cbStruct

Необходимо задать размер структуры JET_RETINFO в байтах и служит для подтверждения наличия следующих полей.

ibLongValue

Смещение до первого байта, извлекаемого из столбца типа JET_coltypLongBinary или JET_coltypLongText. Обратите внимание, что объем данных, полученных из этого смещения, меньше размера выходного буфера и размера данных в фактическом значении после этого смещения.

itagSequence

Описывает порядковый номер значения в столбце с несколькими значениями. Обратите внимание, что массив значений является одноуровневый. Первое значение — это последовательность 1, а не 0. Если столбец записи имеет только одно значение, то в качестве значения itagSequence должно быть передано 1.

Если столбец может содержать несколько значений, можно использовать порядковый номер больше 1 в JetSetColumn и JetRetrieveColumn или 0 в JetSetColumn. В текущей реализации подсистемы любой столбец, созданный с помощью JET_bitColumnTagged, может содержать несколько значений. Столбцы, созданные с помощью JET_bitColumnMultiValued отличаются от столбцов с тегами с несколькими значениями только тем, как они индексируются. Дополнительные сведения см. в разделе JET_INDEXCREATE .

columnidNextTagged

Возвращает columnid полученного столбца с тегами, многозначного или разреженного столбца, если все столбцы с тегами извлекаются путем передачи 0 в качестве columnid в JetRetrieveColumn.

Требования

Требование Значение

Клиент

Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная.

Сервер

Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.

Верхняя часть

Объявлено в Esent.h.

См. также:

JET_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn