Структура JET_ENUMCOLUMN

Статья
06/13/2023

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

Структура JET_ENUMCOLUMN

Структура JET_ENUMCOLUMN перечисляет значения столбцов записи при использовании функции JetEnumerateColumns . JetEnumerateColumns возвращает массив JET_ENUMCOLUMN структур. Массив возвращается в памяти, выделенной с помощью обратного вызова, совместимого с релилоком , который был передан в этот API.

    typedef struct {
      JET_COLUMNID columnid;
      JET_ERR err;
      union {
        struct {
          unsigned long cEnumColumnValue;
          JET_ENUMCOLUMNVALUE rgEnumColumnValue;
        };
        struct {
          unsigned long cbData;
          void* pvData;
        };
      };
    } JET_ENUMCOLUMN;

Элементы

columnid

Идентификатор столбца, который был перечислен.

Err

Код состояния столбца, который является результатом перечисления столбца.

Коды ошибок	Значение
JET_errBadColumnId	Идентификатор столбца выходит за юридические рамки идентификатора столбца.
JET_errColumnNotFound	Столбец, описываемый идентификатором столбца, не существует в таблице.
JET_wrnColumnNull	Все значения этого столбца имеют значение NULL.
JET_wrnColumnPresent	JET_bitEnumeratePresenceOnly было указано, и для этого столбца было возвращено по крайней мере одно значение столбца, отличное от NULL.
JET_wrnColumnSingleValue	JET_bitEnumerateCompressOutput указано, и для этого столбца было возвращено ровно одно значение столбца, отличное от NULL. В результате была возвращена сжатая форма JET_ENUMCOLUMN . Дополнительные сведения см. в разделе JET_ENUMCOLUMN .
JET_wrnColumnSkipped	Идентификатор столбца в структуре JET_ENUMCOLUMNID , соответствующей этой JET_ENUMCOLUMN структуре, равен нулю.

cEnumColumnValue

Массив значений столбцов, перечисленных для столбца. Выходной буфер возвращается в памяти, выделенной с помощью обратного вызова, совместимого с realloc , который был передан в JetEnumerateColumns.

Этот выходной буфер используется, если код состояния столбца не равен JET_wrnColumnSingleValue. Дополнительные сведения см. в разделе JetEnumerateColumns.

Возвращается, если "err != JET_wrnColumnSingleValue".

rgEnumColumnValue

Возвращается, если "err != JET_wrnColumnSingleValue".

cbData

Значение столбца, перечисленное для столбца.

Выходной буфер возвращается в памяти, выделенной с помощью обратного вызова, совместимого с realloc , который был передан в JetEnumerateColumns.

Этот выходной буфер используется только в том случае, если код состояния столбца JET_wrnColumnSingleValue. Дополнительные сведения см. в разделе JetEnumerateColumns.

Возвращается, если "err == JET_wrnColumnSingleValue".

pvData

Значение столбца, перечисленное для столбца.

Возвращается, если "err == JET_wrnColumnSingleValue".

Требования

Требование	Значение
Клиент	Требуется Windows Vista, Windows XP или Windows 2000 Professional.
Сервер	Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.
Верхняя часть	Объявлено в Esent.h.

См. также:

JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc

Поделиться через

Структура JET_ENUMCOLUMN