JET_RETINFO 结构

  • 项目

适用于： Windows |Windows Server

JET_RETINFO 结构

JET_RETINFO 结构包含 JetRetrieveColumn 的可选输入和输出参数。 可以传递 null 指针，否则会传递指向此结构的指针。 传递 null 指针与传递 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 开始。 第一个值是序列 1，而不是 0。 如果记录列只有一个值，则应将 1 作为 itagSequence 传递

对于可以包含多个值的列，只能在 JetSetColumn 和 JetRetrieveColumn 中使用大于 1 的序列号，或者在 JetSetColumn 中使用大于 0 的序列号。 在引擎的当前实现中，使用 JET_bitColumnTagged 创建的任何列都可以包含多个值。 使用JET_bitColumnMultiValued创建的列不同于多值标记列，仅因为它们的索引方式。 有关详细信息 ，请参阅JET_INDEXCREATE 。

columnidNextTagged

通过将 0 作为 columnid 传递给 JetRetrieveColumn 来检索所有标记的列时，返回检索到的标记、多值或稀疏列的列的列 id。

要求

要求 值

客户端

需要 Windows Vista、Windows XP 或 Windows 2000 Professional。

服务器

需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。

标头

在 Esent.h 中声明。

另请参阅

JET_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn