JET_ENUMCOLUMNVALUE Structure

Applies to: Windows | Windows Server

JET_ENUMCOLUMNVALUE Structure

The JET_ENUMCOLUMNVALUE structure enumerates the column values of a record using the JetEnumerateColumns function. JetEnumerateColumns returns an array of JET_ENUMCOLUMNVALUE structures. The array is returned in memory that was allocated using the realloc compatible callback that was supplied to that function.

    typedef struct {
      unsigned long itagSequence;
      JET_ERR err;
      unsigned long cbData;
      void* pvData;
    } JET_ENUMCOLUMNVALUE;

Members

itagSequence

The column value (by one-based index) that was enumerated.

err

The column status code resulting from the enumeration of the column value.

Value

Meaning

JET_wrnColumnNull

The requested column value is NULL.

JET_wrnColumnSkipped

The itagSequence that is specified in the element of the rgtagSequence array in the JET_ENUMCOLUMN struct corresponding to this JET_ENUMCOLUMNVALUE struct was zero.

JET_wrnColumnTruncated

The requested column value was truncated to the specified size before being returned.

This truncation occurs only for long text and long binary columns that contain large amounts of data.

cbData

The column value that was enumerated for the column.

The output buffer is returned in memory that was allocated using the realloc compatible callback that was supplied to JetEnumerateColumns.

pvData

The column value that was enumerated for the column.

The output buffer is returned in memory that was allocated using the realloc compatible callback that was supplied to JetEnumerateColumns.

Requirements

Requirement Value

Client

Requires Windows Vista, Windows XP, or Windows 2000 Professional.

Server

Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.

Header

Declared in Esent.h.

See Also

JET_ENUMCOLUMN
JET_ENUMCOLUMNVALUE
JET_ERR
JetEnumerateColumns
realloc