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_coltypLongBinaryJET_coltypLongText 的列检索的第一个字节的偏移量。 请注意,从此偏移量检索到的数据量是输出缓冲区大小的较小值,以及此偏移量之后实际值中的数据大小。

itagSequence

描述多值列中值的序列号。 请注意,值的数组从 1 开始。 第一个值是序列 1,而不是 0。 如果记录列只有一个值,则应将 1 作为 itagSequence 传递

对于可以包含多个值的列,只能在 JetSetColumnJetRetrieveColumn 中使用大于 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