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

Структура JET_ENUMCOLUMN

  • Статья

Применимо к: 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

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

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

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

cbData

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

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

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

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

pvData

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

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

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

Возвращается, если "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