JET_ENUMCOLUMN 结构

适用于： Windows |Windows Server

JET_ENUMCOLUMN 结构

使用 JetEnumerateColumns 函数时，JET_ENUMCOLUMN 结构枚举记录的列值。 JetEnumerateColumns 返回 JET_ENUMCOLUMN 结构的数组。 数组在内存中返回，该内存使用提供给该 API 的 与 realloc 兼容的回调进行分配。

    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

枚举的列 ID。

err

列的枚举产生的列状态代码。

错误代码	含义
JET_errBadColumnId	列 ID 超出了列 ID 的法定限制。
JET_errColumnNotFound	表中不存在列 ID 描述的列。
JET_wrnColumnNull	此列的所有值为 NULL。
JET_wrnColumnPresent	JET_bitEnumeratePresenceOnly已指定，并且至少为此列返回一个非 NULL 列值。
JET_wrnColumnSingleValue	指定了JET_bitEnumerateCompressOutput，并且为此列只返回了一个非 NULL 列值。 因此，已返回 JET_ENUMCOLUMN 的压缩形式。 有关详细信息 ，请参阅JET_ENUMCOLUMN 。
JET_wrnColumnSkipped	与此JET_ENUMCOLUMN结构对应的JET_ENUMCOLUMNID结构中的列 ID 为零。

cEnumColumnValue

为列枚举的列值的数组。 输出缓冲区在内存中返回，该内存使用提供给 JetEnumerateColumns 的与 realloc 兼容的回调进行分配。

当列状态代码不等于JET_wrnColumnSingleValue时，使用此输出缓冲区。 有关详细信息，请参阅 JetEnumerateColumns。

如果“err ！= JET_wrnColumnSingleValue”，则返回此值。

rgEnumColumnValue

为列枚举的列值的数组。 输出缓冲区在内存中返回，该内存使用提供给 JetEnumerateColumns 的与 realloc 兼容的回调进行分配。

当列状态代码不等于JET_wrnColumnSingleValue时，使用此输出缓冲区。 有关详细信息，请参阅 JetEnumerateColumns。

如果“err ！= JET_wrnColumnSingleValue”，则返回此值。

cbData

为列枚举的列值。

输出缓冲区在内存中返回，该内存使用提供给 JetEnumerateColumns 的与 realloc 兼容的回调进行分配。

仅当列状态代码JET_wrnColumnSingleValue时才使用此输出缓冲区。 有关详细信息，请参阅 JetEnumerateColumns。

如果“err == JET_wrnColumnSingleValue”，则返回此值。

pvData

为列枚举的列值。

输出缓冲区在内存中返回，该内存使用提供给 JetEnumerateColumns 的与 realloc 兼容的回调进行分配。

仅当列状态代码JET_wrnColumnSingleValue时才使用此输出缓冲区。 有关详细信息，请参阅 JetEnumerateColumns。

如果“err == JET_wrnColumnSingleValue”，则返回此值。

要求

要求	值
客户端	需要 Windows Vista、Windows XP 或 Windows 2000 专业版。
服务器	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
标头	在 Esent.h 中声明。

另请参阅

JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc