Структура 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. |